Get-AzDataLakeGen2ChildItem
Bir dizin veya dosya sistemi kökündeki alt dizinleri ve dosyaları listeler.
Syntax
Get-AzDataLakeGen2ChildItem
[-FileSystem] <String>
[[-Path] <String>]
[-FetchProperty]
[-Recurse]
[-MaxCount <Int32>]
[-ContinuationToken <String>]
[-AsJob]
[-OutputUserPrincipalName]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Get-AzDataLakeGen2ChildItem cmdlet'i, azure depolama hesabındaki bir dizindeki veya Dosya sistemindeki alt dizinleri ve dosyaları listeler. Bu cmdlet yalnızca Depolama hesabı için Hiyerarşik Ad Alanı etkinleştirildiğinde çalışır. Bu tür bir hesap, "-EnableHierarchicalNamespace $true" ile "New-Az Depolama Account" cmdlet'i çalıştırılarak oluşturulabilir.
Örnekler
Örnek 1: Dosya Sisteminden doğrudan alt öğeleri listeleme
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
Bu komut bir Dosya Sisteminden doğrudan alt öğeleri listeler
Örnek 2: Dizinden özyinelemeli olarak listeleme ve Özellikler/ACL getirme
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
Bu komut bir Dosya Sisteminden doğrudan alt öğeleri listeler
Örnek 3: Bir Dosya Sisteminden öğeleri birden çok toplu iş halinde yinelemeli olarak listeleme
$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"
Bu örnekte, bir Dosya Sisteminden alınan öğeleri birden çok toplu işte özyinelemeli olarak listelemek için MaxCount ve ContinuationToken parametreleri kullanılır. Küçük bir MaxCount , tek bir requst'tan döndürülen sayı öğelerini sınırlayabilir, işlem zaman aşımı hatasına yardımcı olabilir ve PowerShell'in bellek kullanımını sınırlayabilir. İlk dört komut, örnekte kullanılacak değişkenlere değerler atar. Beşinci komut, öğeleri listelemek için Get-AzDataLakeGen2ChildItem cmdlet'ini kullanan bir Do-While deyimi belirtir. deyimi, $Token değişkeninde depolanan devamlılık belirtecini içerir. $Token, döngü çalıştırılırken değeri değiştirir. Son komut, toplamı görüntülemek için Echo komutunu kullanır.
Parametreler
-AsJob
Cmdlet'i arka planda çalıştırma
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Azure Depolama Bağlam Nesnesi
Type: | IStorageContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContinuationToken
Devamlılık Belirteci.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FetchProperty
datalake öğesi özelliklerini ve ACL'yi getirin.
Type: | SwitchParameter |
Aliases: | FetchPermission |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileSystem
FileSystem adı
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaxCount
Döndürebilecek blobların maksimum sayısı.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputUserPrincipalName
Bu parametreyi speicify, her liste girdisinin sahip ve grup alanlarında döndürülen kullanıcı kimliği değerleri Microsoft Entra Nesne Kimlikleri'nden Kullanıcı Asıl Adları'na dönüştürülür. Bu parametreyi speicify değilse, değerler Microsoft Entra Nesne Kimlikleri olarak döndürülür. Grup ve uygulama Nesne Kimliklerinin benzersiz kolay adları olmadığından çevrilmediğini unutmayın.
Type: | SwitchParameter |
Aliases: | UserPrincipalName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Belirtilen Dosya sistemindeki alınması gereken yol. 'directory1/directory2/' biçiminde bir dizin olmalıdır.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Recurse
Alt Öğeyi özyinelemeli olarak alıp almayacaklarını gösterir. Varsayılan değer false.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |