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

New-CustomPermissions

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

语法

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

指定临时保护策略的到期日期。

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

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