Get-AzDataLakeGen2ChildItem

참조

모듈:: Az.Storage

디렉터리 또는 파일 시스템 루트의 하위 디렉터리 및 파일을 나열합니다.

Syntax

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

Description

Get-AzDataLakeGen2ChildItem cmdlet은 Azure Storage 계정의 디렉터리 또는 Filesystem에 있는 하위 디렉터리 및 파일을 나열합니다. 이 cmdlet은 스토리지 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 작동합니다. 이러한 종류의 계정은 "-EnableHierarchicalNamespace $true"가 있는 "New-AzStorageAccount" cmdlet을 실행하여 만들 수 있습니다.

예제

예제 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: 여러 일괄 처리에서 Filesystem에서 재귀적으로 항목 나열

$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 매개 변수를 사용하여 Filesystem의 항목을 여러 일괄 처리로 재귀적으로 나열합니다. 작은 MaxCount 는 단일 requst에서 반환된 항목 수를 제한하고, 작업 시간 초과 오류에 도움이 될 수 있으며, Powershell의 메모리 사용량을 제한할 수 있습니다. 처음 네 명령은 예제에서 사용할 변수에 값을 할당합니다. 다섯 번째 명령은 Get-AzDataLakeGen2ChildItem cmdlet을 사용하여 항목을 나열하는 Do-While 문을 지정합니다. 이 문에는 $Token 변수에 저장된 연속 토큰이 포함됩니다. $Token 루프가 실행될 때 값을 변경합니다. 마지막 명령은 Echo 명령을 사용하여 합계를 표시합니다.

매개 변수

-AsJob

백그라운드에서 cmdlet 실행

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

-Context

Azure Storage 컨텍스트 개체

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

datalake 항목 속성 및 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

이 매개 변수를 speicify하는 경우 각 목록 항목의 소유자 및 그룹 필드에 반환된 사용자 ID 값이 Microsoft Entra 개체 ID에서 사용자 계정 이름으로 변환됩니다. 이 매개 변수를 지정하지 않으면 값이 Microsoft Entra 개체 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

자식 항목을 재귀적으로 가져올지 나타냅니다. 기본 설정은 거짓입니다.

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

입력

String

IStorageContext

출력

AzureDataLakeGen2Item

Share via