Share via

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

New-AIPCustomPermissions

  • 参考
模块:
AzureInformationProtection

相关内容： 仅限 AIP 统一标记客户端

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

语法

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

说明

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