Platform: WindowsProducts: Managed Backup (Agent)
Article ID: m2035Last Modified: 16-Oct-2024
Remove-MBSAPIUser
Deletes specified user and all user-related information.
Remove-MBSAPIUser
		[[-ID] <String>]
		[-Force]
		[-DeleteData]
		[[-ProfileName] <String>]
		[<CommonParameters>]
Description
Calls DELETE request to https://api.mspbackups.com/api/Users
Examples
Example 1: Remove backup user by ID in force mode (no confirmation)
PS C:\> Remove-MBSAPIUser -id 7c7044bb-313b-4b1b-900e-76d652246f4d -Force -ProfileName MyProfile
Example 2: Remove backup user and all user-related backup data by ID
PS C:\> Remove-MBSAPIUser -id 7c7044bb-313b-4b1b-900e-76d652246f4d -DeleteData -Force -ProfileName MyProfile
Parameters
-ID
User ID. User Get-MBSAPIUser to list MBS backup users.
| Type | String | 
| Required: | false | 
| Position: | 1 | 
| Default value: | |
| Accept pipeline input: | true (ByPropertyName) | 
| Accept wildcard characters: | false | 
-Force
Force delete. Confirmation is disabled.
| Type | SwitchParameter | 
| Required: | false | 
| Position: | named | 
| Default value: | False | 
| Accept pipeline input: | false | 
| Accept wildcard characters: | false | 
-DeleteData
Deletes specified user and all user-related backup data. Data will be deleted during the day.
| 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: | 2 | 
| 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