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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Objek Konteks Azure Storage
Jenis: | IStorageContext |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContinuationToken
Token Kelanjutan.
Jenis: | String |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.
Jenis: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FetchProperty
Ambil properti item datalake dan ACL.
Jenis: | SwitchParameter |
Aliases: | FetchPermission |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileSystem
Nama FileSystem
Jenis: | String |
Position: | 0 |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaxCount
Jumlah maksimum blob yang dapat kembali.
Jenis: | Nullable<T>[Int32] |
Position: | Named |
nilai default: | None |
Diperlukan: | 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.
Jenis: | SwitchParameter |
Aliases: | UserPrincipalName |
Position: | Named |
nilai default: | None |
Diperlukan: | 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/'.
Jenis: | String |
Position: | 1 |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Recurse
Menunjukkan apakah akan secara rekursif mendapatkan Item Anak. Defaultnya adalah false.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Output
Azure PowerShell
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk