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

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

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

-Context

Azure Storage Context オブジェクト

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

-ContinuationToken

継続トークン。

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

-DefaultProfile

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

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

-FetchProperty

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

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

-FileSystem

FileSystem 名

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

-MaxCount

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

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OutputUserPrincipalName

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

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

-Path

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

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

-Recurse

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

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

入力

String

IStorageContext

出力

AzureDataLakeGen2Item