Bagikan melalui


Get-AzDataLakeGen2ChildItem

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Context

Objek Konteks Azure Storage

Jenis:IStorageContext
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ContinuationToken

Token Kelanjutan.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

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

Jenis:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-FetchProperty

Ambil properti item datalake dan ACL.

Jenis:SwitchParameter
Alias:FetchPermission
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-FileSystem

Nama FileSystem

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-MaxCount

Jumlah maksimum blob yang dapat kembali.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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.

Jenis:SwitchParameter
Alias:UserPrincipalName
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Path

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

Jenis:String
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Recurse

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

IStorageContext

Output

AzureDataLakeGen2Item