Share via


Set-AipServiceDocumentRevoked

Revokes access for specified users, to a specified tracked and protected document.

Syntax

Set-AipServiceDocumentRevoked
   [-Force]
   -ContentId <Guid>
   - IssuerName <String>
   [-WhatIf]
    [-Confirm] 
   [<CommonParameters>]

Description

Relevant for the unified labeling client only

The Set-AipServiceDocumentRevoked cmdlet revokes access to a specified document, based on the document's contentID and Rights Management issuer.

To retrieve the contentID for a specific document, use the Get-AipServiceDocumentLog cmdlet.

Examples

Example 1: Revoke access to a specific protected document

PS C:\>Set-AipServiceDocumentRevoked -ContentId c03bf90c-6e40-4f3f-9ba0-2bcd77524b87 - IssuerName  “alice@microsoft.com”

This command revokes access to the document identified using the c03bf90c-6e40-4f3f-9ba0-2bcd77524b87 contentID and This command sets the document state as revoked for the document with contentId as c03bf90c-6e40-4f3f-9ba0-2bcd77524b87 & IssuerName as alice@microsoft.com.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentId

Specifies the email address of a user or group to have administrative rights for the protection service. If the user has no email address, specify the user's Universal Principal Name.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False