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