Set-ITGlueOrganization

SYNOPSIS

Updates one or more organizations

SYNTAX

Bulk_Update (Default)

Set-ITGlueOrganization [-FilterID <Int64>] [-FilterName <String>] [-FilterOrganizationTypeID <Int64>]
 [-FilterOrganizationStatusID <Int64>] [-FilterCreatedAt <String>] [-FilterUpdatedAt <String>]
 [-FilterMyGlueAccountID <Int64>] [-FilterPsaIntegrationType <String>] [-FilterGroupID <Int64>]
 [-FilterPrimary <String>] [-FilterExcludeID <Int64>] [-FilterExcludeName <String>]
 [-FilterExcludeOrganizationTypeID <Int64>] [-FilterExcludeOrganizationStatusID <Int64>] -Data <Object>
 [-WhatIf] [-Confirm] [<CommonParameters>]

Update

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

Bulk_Update_PSA

Set-ITGlueOrganization [-FilterID <Int64>] [-FilterName <String>] [-FilterOrganizationTypeID <Int64>]
 [-FilterOrganizationStatusID <Int64>] [-FilterCreatedAt <String>] [-FilterUpdatedAt <String>]
 [-FilterMyGlueAccountID <Int64>] [-FilterPsaID <String>] -FilterPsaIntegrationType <String>
 [-FilterGroupID <Int64>] [-FilterPrimary <String>] [-FilterExcludeID <Int64>] [-FilterExcludeName <String>]
 [-FilterExcludeOrganizationTypeID <Int64>] [-FilterExcludeOrganizationStatusID <Int64>] -Data <Object>
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The Set-ITGlueOrganization cmdlet updates the details of an existing organization or multiple organizations

Any attributes you don’t specify will remain unchanged

Returns 422 Bad Request error if trying to update an externally synced record on attributes other than: alert, description, quick_notes

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

EXAMPLES

EXAMPLE 1

Set-ITGlueOrganization -id 8765309 -Data $JsonObject

Updates an organization with the specified JSON object

EXAMPLE 2

Set-ITGlueOrganization -FilterOrganizationStatusID 12345 -Data $JsonObject

Updates all defined organization with the specified JSON object

PARAMETERS

-ID

Update an organization by id

Type: Int64
Parameter Sets: Update
Aliases:

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

-FilterID

Filter by an organization id

Type: Int64
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_id

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

-FilterName

Filter by an organization name

Type: String
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_name

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

-FilterOrganizationTypeID

Filter by an organization type id

Type: Int64
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_organization_type_id

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

-FilterOrganizationStatusID

Filter by an organization status id

Type: Int64
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_organization_status_id

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

-FilterCreatedAt

Filter by when an organization created

Type: String
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_created_at

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

-FilterUpdatedAt

Filter by when an organization updated

Type: String
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_updated_at

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

-FilterMyGlueAccountID

Filter by a MyGlue id

Type: Int64
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_my_glue_account_id

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

-FilterPsaID

Filter by a PSA id

Type: String
Parameter Sets: 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
Aliases: filter_psa_integration_type

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

Type: String
Parameter Sets: Bulk_Update_PSA
Aliases: filter_psa_integration_type

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

-FilterGroupID

Filter by a group id

Type: Int64
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_group_id

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

-FilterPrimary

Filter for primary organization

Allowed values: ‘true’, ‘false’

Type: String
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_primary

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

-FilterExcludeID

Filter to excluded a certain organization id

Type: Int64
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_exclude_id

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

-FilterExcludeName

Filter to excluded a certain organization name

Type: String
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_exclude_name

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

-FilterExcludeOrganizationTypeID

Filter to excluded a certain organization type id

Type: Int64
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_exclude_organization_type_id

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

-FilterExcludeOrganizationStatusID

Filter to excluded a certain organization status id

Type: Int64
Parameter Sets: Bulk_Update, Bulk_Update_PSA
Aliases: filter_exclude_organization_status_id

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

-Data

JSON object or array depending on bulk changes or not

Type: Object
Parameter Sets: (All)
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/Organizations/Set-ITGlueOrganization.html

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