Set-ITGlueConfiguration

SYNOPSIS

Updates one or more configurations

SYNTAX

Bulk_Update (Default)

Set-ITGlueConfiguration -Data <Object> [-WhatIf] [-Confirm] [<CommonParameters>]

Update

Set-ITGlueConfiguration -ID <Int64> [-OrganizationID <Int64>] -Data <Object> [-WhatIf] [-Confirm]
 [<CommonParameters>]

Bulk_Update_RMM_PSA

Set-ITGlueConfiguration [-FilterID <Int64>] [-FilterName <String>] [-FilterOrganizationID <Int64>]
 [-FilterConfigurationTypeID <Int64>] [-FilterConfigurationStatusID <Int64>] [-FilterContactID <Int64>]
 [-FilterSerialNumber <String>] [-FilterMacAddress <String>] [-FilterAssetTag <String>] [-FilterPsaID <String>]
 -FilterPsaIntegrationType <String> [-FilterRmmID <String>] -FilterRmmIntegrationType <String>
 [-FilterArchived <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Bulk_Update_PSA

Set-ITGlueConfiguration [-FilterID <Int64>] [-FilterName <String>] [-FilterOrganizationID <Int64>]
 [-FilterConfigurationTypeID <Int64>] [-FilterConfigurationStatusID <Int64>] [-FilterContactID <Int64>]
 [-FilterSerialNumber <String>] [-FilterMacAddress <String>] [-FilterAssetTag <String>] [-FilterPsaID <String>]
 -FilterPsaIntegrationType <String> [-FilterRmmIntegrationType <String>] [-FilterArchived <String>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

Bulk_Update_RMM

Set-ITGlueConfiguration [-FilterID <Int64>] [-FilterName <String>] [-FilterOrganizationID <Int64>]
 [-FilterConfigurationTypeID <Int64>] [-FilterConfigurationStatusID <Int64>] [-FilterContactID <Int64>]
 [-FilterSerialNumber <String>] [-FilterMacAddress <String>] [-FilterAssetTag <String>]
 [-FilterPsaIntegrationType <String>] [-FilterRmmID <String>] -FilterRmmIntegrationType <String>
 [-FilterArchived <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Bulk_Update_rmm_psa

Set-ITGlueConfiguration -Data <Object> [-WhatIf] [-Confirm] [<CommonParameters>]

Bulk_Update_psa

Set-ITGlueConfiguration -Data <Object> [-WhatIf] [-Confirm] [<CommonParameters>]

Bulk_Update_rmm

Set-ITGlueConfiguration -Data <Object> [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The Set-ITGlueConfiguration cmdlet updates the details of one or more existing configurations

Any attributes you don’t specify will remain unchanged

This function can call the following endpoints: Update = /configurations/:id /organizations/:organization_id/relationships/configurations/:id

Bulk_Update =  /configurations

Examples of JSON objects can be found under ITGlues developer documentation https://api.itglue.com/developer

EXAMPLES

EXAMPLE 1

Set-ITGlueConfiguration -ID 8765309 -OrganizationID 8765309 -Data $JsonObject

Updates a defined configuration in the defined organization with the structured JSON object

PARAMETERS

-ID

A valid configuration Id

Type: Int64
Parameter Sets: Update
Aliases:

Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-OrganizationID

A valid organization Id in your account

Type: Int64
Parameter Sets: Update
Aliases: org_id, organization_id

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-FilterID

Filter by configuration id

Type: Int64
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_id

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-FilterName

Filter by configuration name

Type: String
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_name

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterOrganizationID

Filter by organization name

Type: Int64
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_organization_id

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-FilterConfigurationTypeID

Filter by configuration type id

Type: Int64
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_configuration_type_id

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-FilterConfigurationStatusID

Filter by configuration status id

Type: Int64
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_configuration_status_id

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-FilterContactID

Filter by contact id

Type: Int64
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_contact_id

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-FilterSerialNumber

Filter by a configurations serial number

Type: String
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_serial_number

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterMacAddress

Filter by a configurations mac address

Type: String
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_mac_address

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterAssetTag

Filter by a configurations asset tag

Type: String
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_asset_tag

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterPsaID

Filter by a PSA id

Type: String
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA
Aliases: filter_psa_id

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterPsaIntegrationType

Filter by a PSA integration type

Allowed values: ‘manage’, ‘autotask’, ‘tigerpaw’, ‘kaseya-bms’, ‘pulseway-psa’, ‘vorex’

Type: String
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA
Aliases: filter_psa_integration_type

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Type: String
Parameter Sets: Bulk_Update_RMM
Aliases: filter_psa_integration_type

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterRmmID

Filter by a RMM id

Type: String
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_RMM
Aliases: filter_rmm_id

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterRmmIntegrationType

Filter by a RMM integration type

Allowed values: ‘addigy’, ‘aem’, ‘atera’, ‘auvik’, ‘managed-workplace’, ‘continuum’, ‘jamf-pro’, ‘kaseya-vsa’, ‘automate’, ‘log-me-in’, ‘msp-rmm’, ‘meraki’, ‘msp-n-central’, ‘ninja-rmm’, ‘panorama9’, ‘pulseway-rmm’, ‘syncro’, ‘watchman-monitoring’

Type: String
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_RMM
Aliases: filter_rmm_integration_type

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Type: String
Parameter Sets: Bulk_Update_PSA
Aliases: filter_rmm_integration_type

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterArchived

Filter for archived

Allowed values: (case-sensitive) ‘true’, ‘false’, ‘0’, ‘1’

Type: String
Parameter Sets: Bulk_Update_RMM_PSA, Bulk_Update_PSA, Bulk_Update_RMM
Aliases: filter_archived

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Data

JSON object or array depending on bulk changes or not

Type: Object
Parameter Sets: Bulk_Update, Update, Bulk_Update_rmm_psa, Bulk_Update_psa, Bulk_Update_rmm
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

N/A

RELATED LINKS

https://celerium.github.io/ITGlue-PowerShellWrapper/site/Configurations/Set-ITGlueConfiguration.html

https://api.itglue.com/developer/#configurations-update