Remove-AzDataLakeGen2AclRecursive

リファレンス

モジュール:: Az.Storage

指定したパスで ACL を再帰的に削除します。

構文

Remove-AzDataLakeGen2AclRecursive
      [-FileSystem] <String>
      [[-Path] <String>]
      [-ContinuationToken <String>]
      -Acl <PSPathAccessControlEntry[]>
      [-ContinueOnFailure]
      [-BatchSize <Int32>]
      [-MaxBatchCount <Int32>]
      [-AsJob]
      [-Context <IStorageContext>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-AzDataLakeGen2AclRecursive コマンドレットは、指定したパスで ACL を再帰的に削除します。入力 ACL エントリ (アクセス許可が異なる場合でも) wil lbe が削除された、同じ AccessControlType、DefaultScope、EntityId を持つ、元の ACL の ACL エントリ。

例

例 1: ファイルシステムのルートダイレクトで ACL を再帰的に削除する

$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -EntityId $id -Permission r-x -DefaultScope
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -EntityId $id -Permission r-x -InputObject $acl
Remove-AzDataLakeGen2AclRecursive -FileSystem "filesystem1" -Acl $acl -Context $ctx
WARNING: To find the ACL Entry to remove, will only compare AccessControlType, DefaultScope and EntityId, will omit Permission.

FailedEntries                   : 
TotalDirectoriesSuccessfulCount : 7
TotalFilesSuccessfulCount       : 5
TotalFailureCount               : 0
ContinuationToken               :

このコマンドは、最初に 2 つの ACL エントリを持つ ACL オブジェクトを作成し、次にファイルシステムのルートディレクトリで ACL を再帰的に削除します。

例 2: ディレクトリで ACL を再帰的に削除する

$result = Remove-AzDataLakeGen2AclRecursive -FileSystem "filesystem1" -Path "dir1" -Acl $acl  -Context $ctx
WARNING: To find the ACL Entry to remove, will only compare AccessControlType, DefaultScope and EntityId, will omit Permission.

$result

FailedEntries                   : {dir1/dir2/file4}
TotalDirectoriesSuccessfulCount : 500
TotalFilesSuccessfulCount       : 2500
TotalFailureCount               : 1
ContinuationToken               : VBaHi5TfyO2ai1wYTRhIL2FjbGNibjA2c3RmATAxRDVEN0UzRENFQzZCRTAvYWRsc3Rlc3QyATAxRDY2M0ZCQTZBN0JGQTkvZGlyMC9kaXIxL2ZpbGUzFgAAAA==

$result.FailedEntries

Name            IsDirectory ErrorMessage                                                                   
----            ----------- ------------                                                                   
dir0/dir2/file4       False This request is not authorized to perform this operation using this permission.

# user need fix the failed item , then can resume with ContinuationToken

$result = Remove-AzDataLakeGen2AclRecursive -FileSystem "filesystem1" -Path "dir1" -Acl $acl -ContinuationToken $result.ContinuationToken -Context $ctx
WARNING: To find the ACL Entry to remove, will only compare AccessControlType, DefaultScope and EntityId, will omit Permission.

$result

FailedEntries                   : 
TotalDirectoriesSuccessfulCount : 100
TotalFilesSuccessfulCount       : 1000
TotalFailureCount               : 0
ContinuationToken               :

このコマンドは、最初にディレクトリで ACL を再帰的に削除し、失敗した後、ユーザーが失敗したファイルを修正した後に ContinuationToken で再開します。

例 3: ACL を再帰的にチャンク単位で削除する

$token = $null
$TotalDirectoriesSuccess = 0
$TotalFilesSuccess = 0
$totalFailure = 0
$FailedEntries = New-Object System.Collections.Generic.List[System.Object]
do
{
    $result = Remove-AzDataLakeGen2AclRecursive -FileSystem "filesystem1" -Path "dir1" -Acl $acl  -BatchSize 1000 -MaxBatchCount 50 -ContinuationToken $token -Context $ctx

    # echo $result
    $TotalFilesSuccess += $result.TotalFilesSuccessfulCount
    $TotalDirectoriesSuccess += $result.TotalDirectoriesSuccessfulCount
    $totalFailure += $result.TotalFailureCount
    $FailedEntries += $result.FailedEntries
    $token = $result.ContinuationToken
}while (($token -ne $null) -and ($result.TotalFailureCount -eq 0))
echo ""
echo "[Result Summary]"
echo "TotalDirectoriesSuccessfulCount: `t$($TotalDirectoriesSuccess)"
echo "TotalFilesSuccessfulCount: `t`t`t$($TotalFilesSuccess)"
echo "TotalFailureCount: `t`t`t`t`t$($totalFailure)"
echo "ContinuationToken: `t`t`t`t`t$($token)"
echo "FailedEntries:"$($FailedEntries | ft)

このスクリプトでは、ディレクトリチャンクの ACL がチャンクごとに繰り返し削除され、チャンクサイズは BatchSize * MaxBatchCount になります。このスクリプトでは、チャンクサイズは 50000 です。

例 4: ディレクトリと ContinueOnFailure で ACL を再帰的に削除し、エラーから 1 つずつ再開する

$result = Remove-AzDataLakeGen2AclRecursive -FileSystem "filesystem1" -Path "dir1" -Acl $acl -ContinueOnFailure -Context $ctx

$result

FailedEntries                   : {dir0/dir1/file1, dir0/dir2/file4}
TotalDirectoriesSuccessfulCount : 100
TotalFilesSuccessfulCount       : 500
TotalFailureCount               : 2
ContinuationToken               : VBaHi5TfyO2ai1wYTRhIL2FjbGNibjA2c3RmATAxRDVEN0UzRENFQzZCRTAvYWRsc3Rlc3QyATAxRDY2M0ZCQTZBN0JGQTkvZGlyMC9kaXIxL2ZpbGUzFgAAAA==

$result.FailedEntries

Name            IsDirectory ErrorMessage                                                                   
----            ----------- ------------                                                                   
dir0/dir1/file1       False This request is not authorized to perform this operation using this permission.
dir0/dir2/file4       False This request is not authorized to perform this operation using this permission.

# user need fix the failed item , then can resume with ContinuationToken

foreach ($path in $result.FailedEntries.Name)
        {
            # user code to fix failed entry in $path
            
            #set ACL again
            Remove-AzDataLakeGen2AclRecursive -FileSystem "filesystem1" -Path $path -Acl $acl -Context $ctx
        }

このコマンドは、最初に ContinueOnFailure を使用してディレクトリに ACL を再帰的に削除し、一部の項目が失敗した後、失敗した項目を 1 つずつ再開します。

パラメーター

-Acl

ファイルまたはディレクトリに対して再帰的に設定する POSIX アクセス制御リスト。

型:	PSPathAccessControlEntry[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AsJob

バックグラウンドでコマンドレットを実行する

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-BatchSize

データセットのサイズがバッチサイズを超える場合、操作は複数の要求に分割され、進行状況を追跡できます。バッチサイズは 1 から 2000 の間にする必要があります。既定値は 2000 です。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Context

Azure Storage Context オブジェクト

型:	IStorageContext
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ContinuationToken

継続トークン。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ContinueOnFailure

このパラメーターを設定すると、エラーが無視され、ディレクトリの他のサブエンティティに対する操作の処理が続行されます。既定では、エラーが発生すると、操作は迅速に終了します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

型:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FileSystem

FileSystem 名

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-MaxBatchCount

1 回の変更アクセス制御操作で実行できるバッチの最大数。データセットのサイズが MaxBatchCount 乗算 BatchSize を超えると、継続トークンが返されます。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Path

ACL を再帰的に変更する、指定した FileSystem 内のパス。ファイルまたはディレクトリを指定できます。 'directory/file.txt' または 'directory1/directory2/' の形式。このパラメーターをスキップして、ファイルシステムのルートディレクトリから ACL を再帰的に変更します。

型:	String
配置:	1
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

String

IStorageContext

出力

String

次の方法で共有

Remove-AzDataLakeGen2AclRecursive

構文

説明

例

例 1: ファイルシステムのルートダイレクトで ACL を再帰的に削除する

例 2: ディレクトリで ACL を再帰的に削除する

例 3: ACL を再帰的にチャンク単位で削除する

例 4: ディレクトリと ContinueOnFailure で ACL を再帰的に削除し、エラーから 1 つずつ再開する

パラメーター

-Acl

-AsJob

-BatchSize

-Confirm

-Context

-ContinuationToken

-ContinueOnFailure

-DefaultProfile

-FileSystem

-MaxBatchCount

-Path

-WhatIf

入力

出力

その他のリソース

次の方法で共有

Remove-AzDataLakeGen2AclRecursive

構文

説明

例

例 1: ファイルシステムのルート ダイレクトで ACL を再帰的に削除する

例 2: ディレクトリで ACL を再帰的に削除する

例 3: ACL を再帰的にチャンク単位で削除する

例 4: ディレクトリと ContinueOnFailure で ACL を再帰的に削除し、エラーから 1 つずつ再開する

パラメーター

-Acl

-AsJob

-BatchSize

-Confirm

-Context

-ContinuationToken

-ContinueOnFailure

-DefaultProfile

-FileSystem

-MaxBatchCount

-Path

-WhatIf

入力

出力

その他のリソース

例 1: ファイルシステムのルートダイレクトで ACL を再帰的に削除する