Get-AzDataLakeGen2ChildItem

Referensi

Modul:: Az.Storage

Mencantumkan sub direktori dan file dari akar direktori atau sistem file.

Sintaks

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

Deskripsi

Cmdlet Get-AzDataLakeGen2ChildItem mencantumkan sub direktori dan file dalam direktori atau Filesystem di akun penyimpanan Azure. Cmdlet ini hanya berfungsi jika Namespace Hierarki diaktifkan untuk akun Penyimpanan. Akun semacam ini dapat dibuat dengan menjalankan cmdlet "New-AzStorageAccount" dengan "-EnableHierarchicalNamespace $true".

Contoh

Contoh 1: Mencantumkan sub item langsung dari Filesystem

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

Perintah ini mencantumkan sub item langsung dari Filesystem

Contoh 2: Mencantumkan secara rekursif dari direktori, dan mengambil Properti/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

Perintah ini mencantumkan sub item langsung dari Filesystem

Contoh 3: Mencantumkan item secara rekursif dari Filesystem dalam beberapa batch

$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"

Contoh ini menggunakan parameter MaxCount dan ContinuationToken untuk mencantumkan item secara rekursif dari Filesystem dalam beberapa batch. MaxCount kecil dapat membatasi item yang dikembalikan dari requst tunggal, dapat membantu kesalahan waktu operasi habis, dan membatasi penggunaan memori Powershell. Empat perintah pertama menetapkan nilai ke variabel untuk digunakan dalam contoh. Perintah kelima menentukan pernyataan Do-While yang menggunakan cmdlet Get-AzDataLakeGen2ChildItem untuk mencantumkan item. Pernyataan ini mencakup token kelanjutan yang disimpan dalam variabel $Token. $Token mengubah nilai saat perulangan berjalan. Perintah akhir menggunakan perintah Echo untuk menampilkan total.

Parameter

-AsJob

Jalankan cmdlet di latar belakang

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

-Context

Objek Konteks Azure Storage

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

-ContinuationToken

Token Kelanjutan.

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

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

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

-FetchProperty

Ambil properti item datalake dan ACL.

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

-FileSystem

Nama FileSystem

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

-MaxCount

Jumlah maksimum blob yang dapat kembali.

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

-OutputUserPrincipalName

Jika speicify parameter ini, nilai identitas pengguna yang dikembalikan di bidang pemilik dan grup dari setiap entri daftar akan diubah dari ID Objek Microsoft Entra menjadi Nama Prinsipal Pengguna. Jika tidak meluaskan parameter ini, nilai akan dikembalikan sebagai ID Objek Microsoft Entra. Perhatikan bahwa ID Objek grup dan aplikasi tidak diterjemahkan karena tidak memiliki nama ramah yang unik.

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

-Path

Jalur dalam Sistem File yang ditentukan yang harus diambil. Harus berupa direktori, dalam format 'directory1/directory2/'.

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

-Recurse

Menunjukkan apakah akan secara rekursif mendapatkan Item Anak. Defaultnya adalah false.

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

Input

String

IStorageContext

Output

AzureDataLakeGen2Item

Bagikan melalui