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

Set-AzDataLakeStoreItemAclEntry

修改 Data Lake Store 中文件或文件夹的 ACL 中的条目。

语法

Set-AzDataLakeStoreItemAclEntry
   [-Account] <String>
   [-Path] <DataLakeStorePathInstance>
   [-Acl] <DataLakeStoreItemAce[]>
   [-PassThru]
   [-Recurse]
   [-Concurrency <Int32>]
   [-ShowProgress]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzDataLakeStoreItemAclEntry
   [-Account] <String>
   [-Path] <DataLakeStorePathInstance>
   [-AceType] <AceType>
   [[-Id] <Guid>]
   [-Permissions] <Permission>
   [-Default]
   [-PassThru]
   [-Recurse]
   [-Concurrency <Int32>]
   [-ShowProgress]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-AzDataLakeStoreItemAclEntry cmdlet 修改 Data Lake Store 中文件或文件夹的访问控制列表(ACL)中的条目(ACE)。

示例

示例 1:修改 ACE 的权限

Set-AzDataLakeStoreItemAclEntry -AccountName "ContosoADL" -Path / -AceType User -Id (Get-AzADUser -Mail "PattiFuller@contoso.com").ObjectId -Permissions All

此命令将 Patti Fuller 的 ACE 修改为具有所有权限。

示例 2:以递归方式修改 ACE 的权限

Set-AzDataLakeStoreItemAclEntry -AccountName "ContosoADL" -Path / -AceType User -Id (Get-AzADUser -Mail "PattiFuller@contoso.com").ObjectId -Permissions All -Recurse -Concurrency 128

示例 3:使用 Acl 对象以递归方式修改 ACE 的权限

$fullAcl="user:userid1:--x,default:user:userid1:--x"
$newFullAcl = $fullAcl.Split(",")
Set-AzDataLakeStoreItemAclEntry -AccountName "ContosoADL" -Path / -Acl $newFullAcl -Recurse -Concurrency 128 -ShowProgress -Verbose

此命令以递归方式修改 Patti Fuller 的 ACE,使其具有根目录及其所有子目录和文件的所有权限。

参数

-Account

指定 Data Lake Store 帐户的名称。

Type:String
Aliases:AccountName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AceType

指定要修改的 ACE 的类型。 此参数的可接受值为:

  • 用户
  • Mask
  • 其他
Type:Microsoft.Azure.Commands.DataLakeStore.Models.DataLakeStoreEnums+AceType
Accepted values:User, Group, Mask, Other
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Acl

指定包含要修改的条目的 ACL 对象。

Type:DataLakeStoreItemAce[]
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Concurrency

并行处理的文件/目录数。 可选:将选择合理的默认值

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Default

指示此操作修改指定 ACL 中的默认 ACE。

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

指定要为其修改 ACE 的 AzureActive Directory 用户、组或服务主体的对象 ID。

Type:Guid
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

指示应返回生成的 ACL。

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

-Path

指定要从根目录 (/) 开始修改 ACE 的项的 Data Lake Store 路径。

Type:DataLakeStorePathInstance
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Permissions

指定 ACE 的权限。 此参数的可接受值为:

  • 执行
  • WriteExecute
  • 读取
  • ReadExecute
  • ReadWrite
  • 全部
Type:Microsoft.Azure.Commands.DataLakeStore.Models.DataLakeStoreEnums+Permission
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Recurse

指示要以递归方式修改到子子目录和文件的 ACL

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

-ShowProgress

如果传递,则显示进度状态。 仅当完成递归 Acl 修改时适用。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

输入

String

DataLakeStorePathInstance

DataLakeStoreItemAce[]

Microsoft.Azure.Commands.DataLakeStore.Models.DataLakeStoreEnums+AceType

Guid

Microsoft.Azure.Commands.DataLakeStore.Models.DataLakeStoreEnums+Permission

SwitchParameter

Int32

输出

DataLakeStoreItemAce