Added: Command to add a parent to an adb item

Adb/Adb.psd1

@@ -80,6 +80,7 @@
         'Set-AdbItemProperty'
         'Remove-AdbItemProperty'
         'Add-AdbItemTemplate'
+        'Add-AdbItemParent'
         # Item Validation
         'Test-AdbItemValidation'
     )

Adb/Functions/Add-AdbItemParent.ps1

@@ -0,0 +1,63 @@
+<#
+    .SYNOPSIS
+        Add the parent item to the adb item.
+
+    .DESCRIPTION
+        ...
+
+    .INPUTS
+        None
+
+    .OUTPUTS
+        None
+
+    .EXAMPLE
+        PS C:\> Add-AdbItemParent -Name 'myname' -Parent 'myparent'
+        Add the parent myparent to the item myname.
+#>
+function Add-AdbItemParent
+{
+    [CmdletBinding(SupportsShouldProcess = $true)]
+    param
+    (
+        # The adb session.
+        [Parameter(Mandatory = $false)]
+        [PSTypeName('Adb.Session')]
+        [System.Object]
+        $Session,
+
+        # The item name.
+        [Parameter(Mandatory = $true)]
+        [System.String]
+        $Name,
+
+        # The parent to add to the item.
+        [Parameter(Mandatory = $true)]
+        [System.String]
+        $Parent
+    )
+
+    $Session = Test-AdbSession -Session $Session
+
+    $item = Get-AdbItem -Session $Session -Name $Name
+
+    # Prepare the parent list
+    $parents = [System.String[]] $item.parentsNames
+    $parents += $Parent
+    $parents = $parents | Select-Object -Unique | Sort-Object
+
+    $item = [PSCustomObject] @{
+        name         = $Name
+        parentsNames = $parents
+    }
+
+    $requestSplat = Get-AdbSessionRequestSplat -Session $Session -Method 'Put'
+    $requestSplat['Uri'] = '{0}/items/{1}' -f $Session.Uri, $Name
+    $requestSplat['Body'] = $item | ConvertTo-Json -Compress -Depth 99
+
+    if ($PSCmdlet.ShouldProcess($requestSplat.Uri, $requestSplat.Method.ToUpper()))
+    {
+        Write-Verbose ('{0} {1}   {2}' -f $requestSplat.Method.ToUpper(), $requestSplat.Uri, $requestSplat.Body)
+        Invoke-RestMethod @requestSplat -Verbose:$false -ErrorAction 'Stop' | Out-Null
+    }
+}

CHANGELOG.md

@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ## Unreleased
 
 * Added: Command to add a template to an adb item
+* Added: Command to add a parent to an adb item
 
 ## 1.3.0 - 2020-04-08