New-AIPCustomPermissions

參考

模組:: AzureInformationProtection

與下列專案相關： 僅限 AIP 統一標籤用戶端

建立自訂許可權的臨機操作保護原則。

Syntax

New-AIPCustomPermissions
   -Users <String[]>
   -Permissions <Permissions>
   [-ExpirationDate <DateTime>]
   [<CommonParameters>]

Description

New-AIPCustomPermissions Cmdlet 會為您儲存為變數的自訂許可權建立臨機操作保護原則物件，然後在您執行標籤 Cmdlet Set-AIPFileLabel時用來保護檔案或檔案。

如果套用的標籤已設定為保護設定，則來自臨機操作保護原則的自訂許可權會取代標籤的保護設定。

範例

範例 1 - 為單一使用者建立臨機操作保護原則物件

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com -Permissions Viewer

此命令會建立臨機操作保護原則物件，授與 user1 從檢閱者許可權 contoso.com 許可權，並將此原則儲存在具名許可權的變數中。接著，這個臨機操作保護原則可用來將保護套用至檔案或檔案。

此命令沒有顯示任何輸出。

範例 2 - 為多個使用者建立臨機操作保護原則物件，且具有到期日

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)

此命令會建立臨機操作保護原則物件，該物件會授與來自檢閱者許可權的不同組織許可權的使用者，並同時套用到期日。臨機操作保護原則物件會儲存在具名許可權的變數中，然後可用來將此保護套用至檔案或檔案。

此命令沒有顯示任何輸出。

參數

-ExpirationDate

指定臨機操作保護原則的到期日。

在此到期日之後，指定的使用者將無法再存取檔案或檔案。不過，擁有者和進階使用者一律可以存取檔案，即使達到到期期限也一樣。

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

-Permissions

指定許可權層級，將通常一起使用的許可權群組在一起。使用此參數和 Users 參數，將許可權授與指定的使用者。

若要查看每個許可權層級中包含哪些個別許可權，請參閱許可權等級中包含的許可權。

Type:	Permissions
Accepted values:	Viewer, Reviewer, CoAuthor, CoOwner
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Users

指定有權使用檔案或檔案的使用者。使用此參數和 Permission 參數，將許可權授與指定的使用者或群組。

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

輸入

None

輸出

System.Object

Set-AIPFileLabel