Resources/Configurations.ps1
|
function New-ITGlueConfigurations { Param ( [Nullable[Int64]]$organization_id = $null, [Parameter(Mandatory = $true)] $data ) $resource_uri = '/configurations' if ($organization_id) { $resource_uri = ('/organizations/{0}/relationships/configurations' -f $organization_id) } $body = @{} $body += @{'data' = $data} $body = ConvertTo-Json -InputObject $body -Depth $ITGlue_JSON_Conversion_Depth try { $ITGlue_Headers.Add('x-api-key', (New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList 'N/A', $ITGlue_API_Key).GetNetworkCredential().Password) $rest_output = Invoke-RestMethod -method 'POST' -uri ($ITGlue_Base_URI + $resource_uri) -headers $ITGlue_Headers ` -body $body -ErrorAction Stop -ErrorVariable $web_error } catch { Write-Error $_ } finally { $ITGlue_Headers.Remove('x-api-key') >$null # Quietly clean up scope so the API key doesn't persist } $data = @{} $data = $rest_output return $data } function Get-ITGlueConfigurations { [CmdletBinding(DefaultParameterSetName = 'index')] Param ( [Parameter(ParameterSetName = 'show')] [Nullable[Int64]]$id, [Parameter(ParameterSetName = 'index')] [Parameter(ParameterSetName = 'show')] [Nullable[Int64]]$organization_id = $null, [Parameter(ParameterSetName = 'index')] [Nullable[Int64]]$filter_id = '', [Parameter(ParameterSetName = 'index')] [String]$filter_name = '', [Parameter(ParameterSetName = 'index')] [Nullable[Int64]]$filter_organization_id = $null, [Parameter(ParameterSetName = 'index')] [Nullable[Int64]]$filter_configuration_type_id = $null, [Parameter(ParameterSetName = 'index')] [Nullable[Int64]]$filter_configuration_status_id = $null, [Parameter(ParameterSetName = 'index')] [Nullable[Int64]]$filter_contact_id = $null, [Parameter(ParameterSetName = 'index')] [String]$filter_serial_number = '', [Parameter(ParameterSetName = 'index')] [String]$filter_rmm_id = '', [Parameter(ParameterSetName = 'index')] [ValidateSet('addigy', 'aem', 'atera', 'managed-workplace', ` 'continuum', 'jamf-pro', 'kaseya-vsa', 'automate', ` 'msp-rmm', 'msp-n-central', 'ninja-rmm', 'panorama9', ` 'pulseway-rmm', 'watchman-monitoring')] [String]$filter_rmm_integration_type = '', [Parameter(ParameterSetName = 'index')] [ValidateSet('name', 'id', 'created_at', 'updated-at', ` '-name', '-id', '-created_at', '-updated-at')] [String]$sort = '', [Parameter(ParameterSetName = 'index')] [Nullable[Int64]]$page_number = $null, [Parameter(ParameterSetName = 'index')] [Nullable[int]]$page_size = $null, [Parameter(ParameterSetName = 'index')] [Parameter(ParameterSetName = 'show')] [String]$include = '' ) if($organization_id) { #Switch to nested relationships route $resource_uri = ('/organizations/{0}/relationships/configurations/{1}' -f $organization_id, $id) } else { $resource_uri = ('/configurations/{0}' -f $id) } $body = @{} if ($PSCmdlet.ParameterSetName -eq 'index') { if ($filter_id) { $body += @{'filter[id]' = $filter_id} } if ($filter_name) { $body += @{'filter[name]' = $filter_name} } if ($filter_organization_id) { $body += @{'filter[organization_id]' = $filter_organization_id} } if ($filter_configuration_type_id) { $body += @{'filter[configuration_type_id]' = $filter_configuration_type_id} } if ($filter_configuration_status_id) { $body += @{'filter[configuration_status_id]' = $filter_configuration_status_id} } if ($filter_contact_id) { $body += @{'filter[contact_id]' = $filter_contact_id} } if ($filter_serial_number) { $body += @{'filter[serial_number]' = $filter_serial_number} } if ($filter_rmm_id) { $body += @{'filter[rmm_id]' = $filter_rmm_id} } if ($filter_rmm_integration_type) { $body += @{'filter[rmm_integration_type]' = $filter_rmm_integration_type} } if ($sort) { $body += @{'sort' = $sort} } if ($page_number) { $body += @{'page[number]' = $page_number} } if ($page_size) { $body += @{'page[size]' = $page_size} } } else { #Parameter set "Show" is selected; switch to nested relationships route $resource_uri = ('/organizations/{0}/relationships/configurations/{1}' -f $organization_id, $id) } if($include) { $body += @{'include' = $include} } try { $ITGlue_Headers.Add('x-api-key', (New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList 'N/A', $ITGlue_API_Key).GetNetworkCredential().Password) $rest_output = Invoke-RestMethod -method 'GET' -uri ($ITGlue_Base_URI + $resource_uri) -headers $ITGlue_Headers -body $body } catch { Write-Error $_ } finally { $ITGlue_Headers.Remove('x-api-key') >$null # Quietly clean up scope so the API key doesn't persist } $data = @{} $data = $rest_output return $data } function Set-ITGlueConfigurations { [CmdletBinding(DefaultParameterSetName = 'update')] Param ( [Parameter(ParameterSetName = 'update')] [Nullable[Int64]]$id = $null, [Parameter(ParameterSetName = 'update')] [Nullable[Int64]]$organization_id = $null, [Parameter(ParameterSetName = 'bulk_update')] [Nullable[Int64]]$filter_id = $null, [Parameter(ParameterSetName = 'bulk_update')] [String]$filter_name = '', [Parameter(ParameterSetName = 'bulk_update')] [Nullable[Int64]]$filter_organization_id = $null, [Parameter(ParameterSetName = 'bulk_update')] [Nullable[Int64]]$filter_configuration_type_id = $null, [Parameter(ParameterSetName = 'bulk_update')] [Nullable[Int64]]$filter_configuration_status_id = $null, [Parameter(ParameterSetName = 'bulk_update')] [Nullable[Int64]]$filter_contact_id = $null, [Parameter(ParameterSetName = 'bulk_update')] [String]$filter_serial_number = '', [Parameter(ParameterSetName = 'bulk_update')] [String]$filter_rmm_id = '', [Parameter(ParameterSetName = 'bulk_update')] [ValidateSet('addigy', 'aem', 'atera', 'managed-workplace', ` 'continuum', 'jamf-pro', 'kaseya-vsa', 'automate', ` 'msp-rmm', 'msp-n-central', 'ninja-rmm', 'panorama9', ` 'pulseway-rmm', 'watchman-monitoring')] [String]$filter_rmm_integration_type = '', [Parameter(ParameterSetName = 'update')] [Parameter(ParameterSetName = 'bulk_update')] [Parameter(Mandatory = $true)] $data ) $resource_uri = ('/configurations/{0}' -f $id) if ($flexible_asset_type_id) { $resource_uri = ('/organizations/{0}/relationships/configurations/{1}' -f $organization_id, $id) } $body = @{} if ($PSCmdlet.ParameterSetName -eq 'bulk_update') { if ($filter_id) { $body += @{'filter[id]' = $filter_id} } if ($filter_name) { $body += @{'filter[name]' = $filter_name} } if ($filter_organization_id) { $body += @{'filter[organization_id]' = $filter_organization_id} } if ($filter_configuration_type_id) { $body += @{'filter[configuration_type_id]' = $filter_configuration_type_id} } if ($filter_configuration_status_id) { $body += @{'filter[configuration_status_id]' = $filter_configuration_status_id} } if ($filter_contact_id) { $body += @{'filter[contact_id]' = $filter_contact_id} } if ($filter_serial_number) { $body += @{'filter[serial_number]' = $filter_serial_number} } if ($filter_rmm_id) { $body += @{'filter[rmm_id]' = $filter_rmm_id} } if ($filter_rmm_integration_type) { $body += @{'filter[rmm_integration_type]' = $filter_rmm_integration_type} } } $body += @{'data' = $data} $body = ConvertTo-Json -InputObject $body -Depth $ITGlue_JSON_Conversion_Depth try { $ITGlue_Headers.Add('x-api-key', (New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList 'N/A', $ITGlue_API_Key).GetNetworkCredential().Password) $rest_output = Invoke-RestMethod -method 'PATCH' -uri ($ITGlue_Base_URI + $resource_uri) -headers $ITGlue_Headers ` -body $body -ErrorAction Stop -ErrorVariable $web_error } catch { Write-Error $_ } finally { $ITGlue_Headers.Remove('x-api-key') >$null # Quietly clean up scope so the API key doesn't persist } $data = @{} $data = $rest_output return $data } function Remove-ITGlueConfigurations { [CmdletBinding(DefaultParameterSetName = 'bulk_delete')] Param ( [Parameter(ParameterSetName = 'bulk_delete')] [Nullable[Int64]]$filter_id = $null, [Parameter(ParameterSetName = 'bulk_delete')] [String]$filter_name = '', [Parameter(ParameterSetName = 'bulk_delete')] [Nullable[Int64]]$filter_organization_id = $null, [Parameter(ParameterSetName = 'bulk_delete')] [Nullable[Int64]]$filter_configuration_type_id = $null, [Parameter(ParameterSetName = 'bulk_delete')] [Nullable[Int64]]$filter_configuration_status_id = $null, [Parameter(ParameterSetName = 'bulk_delete')] [Nullable[Int64]]$filter_contact_id = $null, [Parameter(ParameterSetName = 'bulk_delete')] [String]$filter_serial_number = '', [Parameter(ParameterSetName = 'bulk_delete')] [String]$filter_rmm_id = '', [Parameter(ParameterSetName = 'bulk_delete')] [ValidateSet('addigy', 'aem', 'atera', 'managed-workplace', ` 'continuum', 'jamf-pro', 'kaseya-vsa', 'automate', ` 'msp-rmm', 'msp-n-central', 'ninja-rmm', 'panorama9', ` 'pulseway-rmm', 'watchman-monitoring')] [String]$filter_rmm_integration_type = '', [Parameter(ParameterSetName = 'bulk_delete')] [Parameter(Mandatory = $true)] $data ) $resource_uri = ('/configurations/{0}' -f $id) if ($flexible_asset_type_id) { $resource_uri = ('/organizations/{0}/relationships/configurations/{1}' -f $organization_id, $id) } $body = @{} if ($PSCmdlet.ParameterSetName -eq 'bulk_delete') { if ($filter_id) { $body += @{'filter[id]' = $filter_id} } if ($filter_name) { $body += @{'filter[name]' = $filter_name} } if ($filter_organization_id) { $body += @{'filter[organization_id]' = $filter_organization_id} } if ($filter_configuration_type_id) { $body += @{'filter[configuration_type_id]' = $filter_configuration_type_id} } if ($filter_configuration_status_id) { $body += @{'filter[configuration_status_id]' = $filter_configuration_status_id} } if ($filter_contact_id) { $body += @{'filter[contact_id]' = $filter_contact_id} } if ($filter_serial_number) { $body += @{'filter[serial_number]' = $filter_serial_number} } if ($filter_rmm_id) { $body += @{'filter[rmm_id]' = $filter_rmm_id} } if ($filter_rmm_integration_type) { $body += @{'filter[rmm_integration_type]' = $filter_rmm_integration_type} } } $body += @{'data' = $data} $body = ConvertTo-Json -InputObject $body -Depth $ITGlue_JSON_Conversion_Depth try { $ITGlue_Headers.Add('x-api-key', (New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList 'N/A', $ITGlue_API_Key).GetNetworkCredential().Password) $rest_output = Invoke-RestMethod -method 'DELETE' -uri ($ITGlue_Base_URI + $resource_uri) -headers $ITGlue_Headers ` -body $body -ErrorAction Stop -ErrorVariable $web_error } catch { Write-Error $_ } finally { $ITGlue_Headers.Remove('x-api-key') >$null # Quietly clean up scope so the API key doesn't persist } $data = @{} $data = $rest_output return $data } |