New-CustomPermissions

參考

模組:: PurviewInformationProtection

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

語法

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

Description

New-CustomPermissions Cmdlet 會針對您儲存為變數的自定義許可權建立臨機操作保護原則對象，然後在您執行卷標 Cmdlet Set-FileLabel 時用來保護檔案或檔案。

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

範例

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

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

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

此命令不會顯示任何輸出。

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

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

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

此命令不會顯示任何輸出。

參數

-ExpirationDate

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

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

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Permissions

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

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

類型:	Permissions
接受的值:	Viewer, Reviewer, CoAuthor, CoOwner
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Users

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

類型:	String[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

System.Object

共用方式為