你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-CustomPermissions

参考

模块:: PurviewInformationProtection

为自定义权限创建即席保护策略。

语法

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

说明

New-CustomPermissions cmdlet 为作为变量存储的自定义权限创建临时保护策略对象，然后在运行标记 cmdlet Set-FileLabel 时用于保护文件。

如果为保护设置配置了应用的标签，则临时保护策略中的自定义权限将替换标签中的保护设置。

示例

示例 1 - 为单个用户创建临时保护策略对象

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

此命令创建一个即席保护策略对象，该对象通过审阅者权限向 user1 授予 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)

此命令创建一个临时保护策略对象，该对象通过审阅者权限向不同组织的用户授予使用权限，并应用到期日期。临时保护策略对象存储在名为 permissions 的变量中，然后可以使用该变量将此保护应用于一个或多个文件。

此命令未显示任何输出。

参数

-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

通过