Revoke-MBSAPILicense


Removes the association of a license to a specified computer

Revoke-MBSAPILicense
        [-LicenseID] <String>
        [-UserID] <String>
        [[-ProfileName] <String>]
        [<CommonParameters>]

Description

Calls the POST api/Licenses/Revoke API to detach a license form the computer it is currently applied to. The license is moved back to the license pool it was taken from. In case Global Pool is used, user association is also removed. If a user has a custom pool specified, the license retains the attachment to that user's pool. Learn more about pools and license management here: https://help.mspbackups.com/administration/licenses/manage-licenses


Examples

Example 1:

PS C:\> Revoke-MBSAPILicense -ProfileName ao -LicenseID 8fc593d1-bb74-4a52-a644-0a574967df83 -UserID e472840f-e01f-40e0-95fc-b28882a28cfe

Parameters

-LicenseID

The ID of the license to revoke. Use Get-MBSAPILicenses to determine this parameter.

Type String
Required: true
Position 1
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-UserID

The ID of the user that the license is attached to.

Type String
Required: true
Position 2
Default value:
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.

Notes

Author: Andrey Oshukov