Public/Commands/CommandTargets/Add-JCCommandTarget.ps1
|
Function Add-JCCommandTarget { [CmdletBinding(DefaultParameterSetName = 'SystemID')] param ( [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'SystemID', Position = 0, HelpMessage = 'The id value of the JumpCloud command. Use the command "Get-JCCommand | Select-Object _id, name" to find the "_id" value for all the JumpCloud commands in your tenant.')] [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'GroupName', Position = 0, HelpMessage = 'The id value of the JumpCloud command. Use the command "Get-JCCommand | Select-Object _id, name" to find the "_id" value for all the JumpCloud commands in your tenant.')] [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'GroupID', Position = 0, HelpMessage = 'The id value of the JumpCloud command. Use the command "Get-JCCommand | Select-Object _id, name" to find the "_id" value for all the JumpCloud commands in your tenant.')] [Alias('_id', 'id')] [String]$CommandID, [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'SystemID', Position = 1, HelpMessage = 'The _id of a JumpCloud system. To find the _id of all JumpCloud systems within your tenant run "Get-JCSystem | select _id, hostname"')] $SystemID, [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'GroupName', Position = 1, HelpMessage = 'The name of the JumpCloud system group. If the name includes a space enter the name within quotes. Example: -GroupName "The Space"')] [Alias('name')] $GroupName, [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'GroupID', Position = 1, HelpMessage = 'The id value of a JumpCloud system group')] $GroupID ) begin { Write-Verbose "parameter set: $($PSCmdlet.ParameterSetName)" Write-Verbose 'Verifying JCAPI Key' if ($JCAPIKEY.length -ne 40) {Connect-JConline} Write-Verbose 'Populating API headers' $hdrs = @{ 'Content-Type' = 'application/json' 'Accept' = 'application/json' 'X-API-KEY' = $JCAPIKEY } if ($JCOrgID) { $hdrs.Add('x-org-id', "$($JCOrgID)") } if ($PSCmdlet.ParameterSetName -eq 'GroupName') { Write-Verbose 'Populating SystemGroupNameHash' $SystemGroupNameHash = Get-Hash_SystemGroupName_ID } if ($PSCmdlet.ParameterSetName -eq 'SystemID') { Write-Verbose 'Populating CommandID_Type hash' $CommandID_TypeHash = Get-Hash_CommandID_Type Write-Verbose 'Populating SystemID_OS hash' $SystemID_OSHash = Get-Hash_SystemID_OS } Write-Verbose 'Populating CommandNameHash' $CommandNameHash = Get-Hash_CommandID_Name Write-Verbose 'Initilizing RawResults and resultsArrayList' $resultsArray = @() } process { switch ($PSCmdlet.ParameterSetName) { SystemID { $SystemOS_Raw = $SystemID_OSHash.($SystemID) $CommandType = $CommandID_TypeHash.($CommandID) switch ($SystemOS_Raw) { "Mac OS X" { $SystemType = 'mac'} Windows { $SystemType = 'windows'} Default { $SystemType = 'linux' } } if ($SystemType -eq $CommandType) { $OS_conflict = $false } else { $OS_conflict = $true $Status = 'OS_Conflict' } $body = @{ type = "system" op = "add" id = $SystemID } } # end SystemID switch GroupName { $GroupID = $SystemGroupNameHash.($GroupName) $body = @{ type = "system_group" op = "add" id = $GroupID } } # end GroupName switch GroupID { $body = @{ type = "system_group" op = "add" id = $GroupID } } # end GroupID switch } # end switch $jsonbody = $body | ConvertTo-Json $URL = "$JCUrlBasePath/api/v2/commands/$($CommandID)/associations" if ($OS_conflict -ne $true) { try { $APIresults = Invoke-RestMethod -Method Post -Uri $URL -Header $hdrs -Body $jsonbody -UserAgent:(Get-JCUserAgent) $Status = 'Added' } catch { $Status = $_.ErrorDetails } } $CommandName = $CommandNameHash.($CommandID) $FormattedResults = [PSCustomObject]@{ 'CommandID' = $CommandID 'CommandName' = $CommandName 'Type' = $body.type 'id' = $body.id 'Status' = $Status } $resultsArray += $FormattedResults } # end process end { Return $resultsArray } } |