New-CustomPermissions
为自定义权限创建 ad-hoc 保护策略。
语法
Default （默认值）
New-CustomPermissions
-Users <String[]>
-Permissions <Permissions>
[-ExpirationDate <DateTime>]
说明
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 |