New-CustomPermissions
為自定義許可權創建 ad-hoc 保護策略。
語法
Default (預設值)
New-CustomPermissions
-Users <String[]>
-Permissions <Permissions>
[-ExpirationDate <DateTime>]
Description
New-CustomPermissions cmdlet 為自定義許可權創建一個臨時保護策略物件，該物件存儲為變數，然後在運行標記 cmdlet Set-FileLabel 時用於保護一個或多個檔。
如果為保護設置配置了應用的標籤，則臨時保護策略中的自定義許可權將替換標籤中的保護設置。
範例
範例 1 - 為單個使用者建立 ad-hoc 保護策略物件
PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com -Permissions Viewer
此命令將創建一個臨時保護策略物件，該物件授予 user1 從 Reviewer 許可權 contoso.com 使用許可權，並將此策略存儲在名為 permissions 的變數中。 然後，可以使用此臨時保護策略對一個或多個檔應用保護。
此命令不顯示任何輸出。
範例 2 - 為多個使用者創建具有到期日期的臨時保護策略物件
PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)
此命令將創建一個臨時保護策略物件，該物件向來自不同組織的使用者授予 Reviewer 許可權的使用許可權，並應用到期日期。 臨時保護策略物件存儲在名為permissions的變數中，然後可以使用該變數將此保護應用於一個或多個檔。
此命令不顯示任何輸出。
參數
-ExpirationDate
指定臨時保護策略的到期日期。
在此到期日期之後，指定的使用者將無法再訪問一個或多個檔。 但是，擁有者和超級用戶始終可以訪問該檔，即使在到期期限之後也是如此。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Permissions
指定一個許可權級別，該級別對通常一起使用的使用許可權進行分組。 使用此參數和 Users 參數為指定使用者授予使用許可權。
要查看每個許可權級別中包含哪些單獨的使用許可權，請參閱 許可權級別中包含的許可權。
參數屬性
| 類型: | Permissions |
| 預設值: | None |
| 接受的值: | Viewer, Reviewer, CoAuthor, CoOwner |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Users
指定將有權使用一個或多個文件的使用者。 使用此參數和 Permission 參數可向指定的使用者或組授予許可權。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |