Revoke-MgBetaDriveItemPermissionGrant

Module:

Microsoft.Graph.Beta.Files

Revoke access to a listItem or driveItem granted via a sharing link by removing the specified recipient from the link.

Syntax

Revoke-MgBetaDriveItemPermissionGrant
      -DriveId <String>
      -DriveItemId <String>
      -PermissionId <String>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-Grantees <IMicrosoftGraphDriveRecipient[]>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Revoke-MgBetaDriveItemPermissionGrant
      -DriveId <String>
      -DriveItemId <String>
      -PermissionId <String>
      -BodyParameter <IPaths1Cd4L6HDrivesDriveIdItemsDriveitemIdPermissionsPermissionIdMicrosoftGraphRevokegrantsPostRequestbodyContentApplicationJsonSchema>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Revoke-MgBetaDriveItemPermissionGrant
      -InputObject <IFilesIdentity>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-Grantees <IMicrosoftGraphDriveRecipient[]>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Revoke-MgBetaDriveItemPermissionGrant
      -InputObject <IFilesIdentity>
      -BodyParameter <IPaths1Cd4L6HDrivesDriveIdItemsDriveitemIdPermissionsPermissionIdMicrosoftGraphRevokegrantsPostRequestbodyContentApplicationJsonSchema>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Revoke access to a listItem or driveItem granted via a sharing link by removing the specified recipient from the link.

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Beta.Files

$params = @{
	grantees = @(
		@{
			email = "ryan@contoso.com"
		}
	)
}

Revoke-MgBetaDriveItemPermissionGrant -DriveId $driveId -DriveItemId $driveItemId -PermissionId $permissionId -BodyParameter $params

This example shows how to use the Revoke-MgBetaDriveItemPermissionGrant Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-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

-DriveId

The unique identifier of drive

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

-DriveItemId

The unique identifier of driveItem

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

-Grantees

. To construct, see NOTES section for GRANTEES properties and create a hash table.

Type:	IMicrosoftGraphDriveRecipient[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Headers

Optional headers that will be added to the request.

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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-PermissionId

The unique identifier of permission

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResponseHeadersVariable

Optional Response Headers Variable.

Type:	String
Aliases:	RHV
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

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IFilesIdentity

Microsoft.Graph.Beta.PowerShell.Models.IPaths1Cd4L6HDrivesDriveIdItemsDriveitemIdPermissionsPermissionIdMicrosoftGraphRevokegrantsPostRequestbodyContentApplicationJsonSchema

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphPermission

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

BODYPARAMETER <IPaths1Cd4L6HDrivesDriveIdItemsDriveitemIdPermissionsPermissionIdMicrosoftGraphRevokegrantsPostRequestbodyContentApplicationJsonSchema>: .

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Grantees <IMicrosoftGraphDriveRecipient- []>]:
  • [Alias <String>]: The alias of the domain object, for cases where an email address is unavailable (e.g. security groups).
  • [Email <String>]: The email address for the recipient, if the recipient has an associated email address.
  • [ObjectId <String>]: The unique identifier for the recipient in the directory.

GRANTEES <IMicrosoftGraphDriveRecipient- []>: .

• [Alias <String>]: The alias of the domain object, for cases where an email address is unavailable (e.g. security groups).
• [Email <String>]: The email address for the recipient, if the recipient has an associated email address.
• [ObjectId <String>]: The unique identifier for the recipient in the directory.

INPUTOBJECT <IFilesIdentity>: Identity Parameter

• [ColumnDefinitionId <String>]: The unique identifier of columnDefinition
• [ColumnLinkId <String>]: The unique identifier of columnLink
• [ContentTypeId <String>]: The unique identifier of contentType
• [ContentTypeId1 <String>]: The unique identifier of contentType
• [DocumentSetVersionId <String>]: The unique identifier of documentSetVersion
• [DriveId <String>]: The unique identifier of drive
• [DriveItemId <String>]: The unique identifier of driveItem
• [DriveItemId1 <String>]: The unique identifier of driveItem
• [DriveItemVersionId <String>]: The unique identifier of driveItemVersion
• [EndDateTime <String>]: Usage: endDateTime='{endDateTime}'
• [GroupId <String>]: The unique identifier of group
• [Interval <String>]: Usage: interval='{interval}'
• [ItemActivityStatId <String>]: The unique identifier of itemActivityStat
• [ListItemId <String>]: The unique identifier of listItem
• [ListItemVersionId <String>]: The unique identifier of listItemVersion
• [PermissionId <String>]: The unique identifier of permission
• [Q <String>]: Usage: q='{q}'
• [RichLongRunningOperationId <String>]: The unique identifier of richLongRunningOperation
• [SharedDriveItemId <String>]: The unique identifier of sharedDriveItem
• [StartDateTime <String>]: Usage: startDateTime='{startDateTime}'
• [SubscriptionId <String>]: The unique identifier of subscription
• [ThumbnailSetId <String>]: The unique identifier of thumbnailSet
• [Token <String>]: Usage: token='{token}'
• [UserId <String>]: The unique identifier of user

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.beta.files/revoke-mgbetadriveitempermissiongrant
• https://learn.microsoft.com/graph/api/permission-revokegrants?view=graph-rest-beta