Set-DattoBulkSeatChange

SYNOPSIS

Sets Datto SaaS Protection bulk seat changes

SYNTAX

Set-DattoBulkSeatChange -saasCustomerId <Int32> -externalSubscriptionId <String> -seatType <String>
 -actionType <String> -remoteId <String[]> [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The Set-DattoBulkSeatChange cmdlet is used to bulk set SaaS Protection seat changes

Both ‘seatType’ & ‘actionType’ parameters are case-sensitive

EXAMPLES

EXAMPLE 1

Set-DattoBulkSeatChange -saasCustomerId "123456" -externalSubscriptionId 'Classic:Office365:654321' -seatType "User" -actionType License -remoteId "ab23-bdf234-1234-asdf"

Sets the Datto SaaS protection seats from the defined Office365 customer ID

EXAMPLE 2

Set-DattoBulkSeatChange -saasCustomerId "123456" -externalSubscriptionId 'Classic:GoogleApps:654321' -seatType "SharedDrive" -actionType Pause -remoteId "ab23-bdf234-1234-asdf","cd45-cfe567-5678-1234"

Sets the Datto SaaS protection seats from the defined Google customer ID

PARAMETERS

-saasCustomerId

Defines the ID of the Datto SaaS organization

Type: Int32
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: 0
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-externalSubscriptionId

Defines the external Subscription ID used to set SaaS bulk seat changes

The externalSubscriptionId can be found by referencing the data returned from Get-DattoApplication

Example: ‘Classic:Office365:654321’ ‘Classic:GoogleApps:654321’

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-seatType

Defines the seat type to backup

This is a case-sensitive value

Seat Types can be found by referencing the data returned from Get-DattoSeat

Example: Office365: ‘User’, ‘SharedMailbox’, ‘Site’, ‘TeamSite’, ‘Team’ Google: ‘User’, ‘SharedDrive’

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-actionType

Defines what action to take against the seat

This is a case-sensitive value

Active (License): The seat exists in the organization and is actively backed up, meaning the seat is protected. Paused (Pause): The seat exists in the organization; backups were enabled but are currently paused. Unprotected (Unlicense): The seat exists in the organization but backups are not enabled.

Allowed values: ‘License’, ‘Pause’, ‘Unlicense’

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-remoteId

Defines the target IDs to change

Remote IDs can be found by referencing the data returned from Get-DattoApplication

Example: ab23-bdf234-1234-asdf

Type: String[]
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
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

This function does not work for legacy Google Seat Management 1.0 system Seat Management details can be found by referencing Datto’s documentation

https://saasprotection.datto.com/help/Google/Content/Managing_service_seats/01_Exploring_seat_management_features.htm

RELATED LINKS

https://celerium.github.io/Datto-PowerShellWrapper/site/SaaS/Set-DattoBulkSeatChange.html