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

New-AIPCustomPermissions

相关内容: 仅限 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

指定即席保护策略的到期日期。

在此到期日期之后,指定的用户将无法再访问文件或文件。 但是,即使达到到期期限,所有者和超级用户也可以始终访问该文件。

类型: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