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

Set-AzDataLakeGen2ItemAclObject

模块:

Az.Storage

创建/汇报 DataLake gen2 项 ACL 对象，可在 Update-AzDataLakeGen2Item cmdlet 中使用。

语法

Set-AzDataLakeGen2ItemAclObject
   [-EntityId <String>]
   [-DefaultScope]
   -Permission <String>
   [-InputObject <PSPathAccessControlEntry[]>]
   -AccessControlType <AccessControlType>
   [<CommonParameters>]

说明

Set-AzDataLakeGen2ItemAclObject cmdlet 创建/更新 DataLake gen2 项 ACL 对象，可在 Update-AzDataLakeGen2Item cmdlet 中使用。 如果输入 ACL 中不存在具有相同 AccessControlType/EntityId/DefaultScope 的新 ACL 条目，则将创建新的 ACL 条目，否则更新现有 ACL 条目的权限。

示例

示例 1：使用 3 个 ACL 条目创建 ACL 对象，并在目录中更新 ACL

$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -Permission rwx -DefaultScope
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType group -Permission rw- -InputObject $acl 
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType other -Permission "rw-" -InputObject $acl
Update-AzDataLakeGen2Item -FileSystem "filesystem1" -Path "dir1/dir3" -ACL $acl

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group               
----                 -----------  ------          ------------         -----------  -----                -----               
dir1/dir3            True                         2020-03-23 09:34:31Z rwxrw-rw-+   $superuser           $superuser

此命令创建包含 3 个 ACL 条目的 ACL 对象（使用 -InputObject 参数将 acl 条目添加到现有 acl 对象），并更新目录中的 ACL。

示例 2：创建包含 4 个 ACL 条目的 ACL 对象，并更新现有 ACL 条目的权限

$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -Permission rwx -DefaultScope
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType group -Permission rw- -InputObject $acl 
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType other -Permission "rwt" -InputObject $acl
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -EntityId $id -Permission rwx -InputObject $acl 
$acl

DefaultScope AccessControlType EntityId                             Permissions
------------ ----------------- --------                             -----------
True         User                                                   rwx        
False        Group                                                  rw-        
False        Other                                                  rwt        
False        User              ********-****-****-****-************ rwx        

$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -EntityId $id -Permission r-x -InputObject $acl 
$acl  

DefaultScope AccessControlType EntityId                             Permissions
------------ ----------------- --------                             -----------
True         User                                                   rwx        
False        Group                                                  rw-        
False        Other                                                  rw-        
False        User              ********-****-****-****-************ r-x

此命令首先创建包含 4 个 ACL 条目的 ACL 对象，然后使用不同的权限再次运行 cmdlet，但现有 ACL 条目的 AccessControlType/EntityId/DefaultScope 相同。 然后更新 ACL 条目的权限，但不会添加新的 ACL 条目。

参数

-AccessControlType

有四种类型：“user”向所有者或命名用户授予权限，“组”向拥有组或命名组授予权限，“掩码”限制向已命名用户和组成员授予的权限，“其他”向任何其他条目中未找到的所有用户授予权限。

Type:	AccessControlType
Accepted values:	User, Group, Mask, Other
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultScope

设置此参数以指示 ACE 属于目录的默认 ACL;否则范围为隐式范围，ACE 属于访问 ACL。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EntityId

用户或组标识符。 对于 AccessControlType“mask”和“other”的条目，将省略它。 所有者和拥有组也省略用户或组标识符。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

如果输入 PSPathAccessControlEntry[] 对象，则会将新的 ACL 添加为输入 PSPathAccessControlEntry[] 对象的新元素。

Type:	PSPathAccessControlEntry[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Permission

权限字段是一个 3 个字符序列，其中第一个字符是“r”来授予读取访问权限，第二个字符是“w”来授予写入访问权限，第三个字符是“x”，用于授予执行权限。 如果未授予访问权限，则使用“-”字符表示拒绝该权限。 粘性位也受支持，并且它由字母 t 或 T 表示在最终字符位置，具体取决于其他类别的执行位是分别设置还是未设置，缺少 t 或 T 表示未设置粘滞位。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

PSPathAccessControlEntry