Get-AzDataLakeGen2ChildItem

リファレンス

モジュール:: Az.Storage

ディレクトリまたはファイルシステムルートのサブディレクトリとファイルを一覧表示します。

構文

Get-AzDataLakeGen2ChildItem
   [-FileSystem] <String>
   [[-Path] <String>]
   [-FetchProperty]
   [-Recurse]
   [-MaxCount <Int32>]
   [-ContinuationToken <String>]
   [-AsJob]
   [-OutputUserPrincipalName]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Get-AzDataLakeGen2ChildItem コマンドレットは、ディレクトリ内のサブディレクトリとファイル、または Azure ストレージアカウントのファイルシステムを一覧表示します。このコマンドレットは、ストレージアカウントに対して階層型名前空間が有効になっている場合にのみ機能します。この種類のアカウントは、"-EnableHierarchicalNamespace $true" を使用して "New-AzStorageAccount" コマンドレットを実行することで作成できます。

例

例 1: ファイルシステムからの直接サブ項目をリストする

Get-AzDataLakeGen2ChildItem -FileSystem "filesystem1"

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group               
----                 -----------  ------          ------------         -----------  -----                -----               
dir1                 True                         2020-03-13 13:07:34Z rwxr-x---    $superuser           $superuser          
dir2                 True                         2020-03-23 09:28:36Z rwxr-x---    $superuser           $superuser

このコマンドは、ファイルシステムからの直接サブ項目を一覧表示します。

例 2: ディレクトリから再帰的に一覧表示し、プロパティ/ACL をフェッチする

Get-AzDataLakeGen2ChildItem -FileSystem "filesystem1" -Path "dir1/" -Recurse -FetchProperty

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group               
----                 -----------  ------          ------------         -----------  -----                -----               
dir1/dir3            True                         2020-03-23 09:34:31Z rwx---rwx    $superuser           $superuser          
dir1/file1           False        1024            2020-03-23 09:29:18Z rwx---rwx    $superuser           $superuser           
dir1/testfile_1K_0   False        1024            2020-03-23 09:29:21Z rw-r-----    $superuser           $superuser

このコマンドは、ファイルシステムからの直接サブ項目を一覧表示します。

例 3: ファイルシステムから複数のバッチで項目を再帰的に一覧表示する

$MaxReturn = 1000
$FileSystemName = "filesystem1"
$Total = 0
$Token = $Null
do
 {
     $items = Get-AzDataLakeGen2ChildItem -FileSystem $FileSystemName -Recurse -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $items.Count
     if($items.Length -le 0) { Break;}
     $Token = $items[$items.Count -1].ContinuationToken;
 }
 While ($null -ne $Token)
Echo "Total $Total items in Filesystem $FileSystemName"

この例では、 MaxCount パラメーターと ContinuationToken パラメーターを使用して、ファイルシステムから複数のバッチで項目を再帰的に一覧表示します。小さな MaxCount では、単一の requst から返されるアイテム数を制限したり、操作タイムアウトエラーに役立つ場合や、Powershell のメモリ使用量を制限したりできます。最初の 4 つのコマンドは、この例で使用する変数に値を割り当てます。 5 番目のコマンドは、Get-AzDataLakeGen2ChildItem コマンドレットを使用して項目を一覧表示する Do-While ステートメントを指定します。ステートメントには、$Token変数に格納されている継続トークンが含まれています。 $Tokenループの実行時に値が変更されます。最後のコマンドでは、 Echo コマンドを使用して合計を表示します。

パラメーター

-AsJob

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

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

-Context

Azure Storage Context オブジェクト

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

-ContinuationToken

継続トークン。

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

-DefaultProfile

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

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

-FetchProperty

データレイク項目のプロパティと ACL をフェッチします。

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

-FileSystem

FileSystem 名

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

-MaxCount

返すことができる BLOB の最大数。

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

-OutputUserPrincipalName

このパラメーターを指定すると、各リストエントリの所有者フィールドとグループフィールドで返されるユーザー ID 値は、Microsoft Entra オブジェクト ID からユーザープリンシパル名に変換されます。このパラメーターを指定しない場合、値は Microsoft Entra オブジェクト ID として返されます。グループ ID とアプリケーションオブジェクト ID は一意のフレンドリ名を持たないため、変換されないことに注意してください。

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

-Path

取得する必要がある指定されたファイルシステム内のパス。 "directory1/directory2/" という形式のディレクトリにする必要があります。

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

-Recurse

子項目を再帰的に取得するかどうかを示します。既定値は false です。

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

入力

String

IStorageContext

出力

AzureDataLakeGen2Item

次の方法で共有