Platform: WindowsProducts: Managed Backup (Agent)
Article ID: m2036Last Modified: 16-Oct-2024
Remove-MBSAPIUserBackupDestination
Unassign a backup destination from a user.
Remove-MBSAPIUserBackupDestination
		[-DestinationID] <String>
		[-UserID] <String>
		[-Force]
		[[-ProfileName] <String>]
		[<CommonParameters>]
Description
Calls the api/Destinations/{id}?userId={userId} DELETE API to remove a backup user destination
Examples
Example 1: Unassign a backup destination from a user.
PS C:\> Remove-MBSAPIUserBackupDestination -ProfileName ao -userID e472840f-e01f-40e0-95fc-b28882a28cfe -DestinationID 33a0dfd1-c072-4d92-8b89-f055d3e114c7
Parameters
-DestinationID
| Type | String | 
| Required: | true | 
| Position: | 1 | 
| Default value: | |
| Accept pipeline input: | false | 
| Accept wildcard characters: | false | 
-UserID
ID of the user whose backup destination will be deleted. Use Get-MBSAPIUser to determine
| Type | String | 
| Required: | true | 
| Position: | 2 | 
| Default value: | |
| Accept pipeline input: | false | 
| Accept wildcard characters: | false | 
-Force
Bypass confirmation prompt for removal operation
| Type | SwitchParameter | 
| Required: | false | 
| Position: | named | 
| Default value: | False | 
| Accept pipeline input: | false | 
| Accept wildcard characters: | false | 
-ProfileName
Profile name used with MSP360 PowerShell for MBS API (set via Set-MBSApiCredential)
| Type | String | 
| Required: | false | 
| Position: | 3 | 
| Default value: | |
| Accept pipeline input: | false | 
| Accept wildcard characters: | false | 
CommonParameters
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters.
Inputs
System.Management.Automation.PSCustomObject
Outputs
String
Notes
Author: MSP360 Onboarding Team