Set-AzDataLakeStoreItemAclEntry

模組:

Az.DataLakeStore

修改 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>]

Description

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 帳戶的名稱。

類型:	String
別名:	AccountName
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-AceType

指定要修改的 ACE 類型。 此參數可接受的值為：

• User
• 群組
• 遮罩
• 其他

類型:	Microsoft.Azure.Commands.DataLakeStore.Models.DataLakeStoreEnums+AceType
接受的值:	User, Group, Mask, Other
Position:	2
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Acl

指定包含要修改之專案的 ACL 物件。

類型:	DataLakeStoreItemAce[]
Position:	2
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Concurrency

平行處理的檔案/目錄數目。 選擇性：將會選取合理的預設值

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Default

表示這項作業會從指定的 ACL 修改預設 ACE。

類型:	SwitchParameter
Position:	4
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

指定要修改 ACE 之 AzureActive Directory 使用者、群組或服務主體的物件識別碼。

類型:	Guid
Position:	3
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-PassThru

表示應該傳回產生的 ACL。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Path

指定要從根目錄 （/） 開始修改 ACE 之專案的 Data Lake Store 路徑。

類型:	DataLakeStorePathInstance
Position:	1
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Permissions

指定 ACE 的許可權。 此參數可接受的值為：

• None
• 執行
• 寫入
• WriteExecute
• 參閱
• ReadExecute
• 讀寫
• 全部

類型:	Microsoft.Azure.Commands.DataLakeStore.Models.DataLakeStoreEnums+Permission
Position:	4
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Recurse

表示要以遞歸方式修改子子目錄和檔案的 ACL

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ShowProgress

如果通過，則會顯示進度狀態。 只有在遞歸 Acl 修改完成時才適用。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

DataLakeStorePathInstance

DataLakeStoreItemAce[]

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

Guid

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

SwitchParameter

Int32

輸出

DataLakeStoreItemAce

相關連結

• Remove-AzDataLakeStoreItemAclEntry