Get-AzDataLakeGen2ChildItem
Bir dizin veya dosya sistemi kökündeki alt dizinleri ve dosyaları listeler.
Sözdizimi
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 $superuserBu 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 $superuserBu 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
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Context
Azure Depolama Bağlam Nesnesi
| Tür: | IStorageContext |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-ContinuationToken
Devamlılık Belirteci.
| Tür: | String |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
| Tür: | IAzureContextContainer |
| Diğer adlar: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-FetchProperty
datalake öğesi özelliklerini ve ACL'yi getirin.
| Tür: | SwitchParameter |
| Diğer adlar: | FetchPermission |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-FileSystem
FileSystem adı
| Tür: | String |
| Position: | 0 |
| Default value: | None |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-MaxCount
Döndürebilecek blobların maksimum sayısı.
| Tür: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | 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.
| Tür: | SwitchParameter |
| Diğer adlar: | UserPrincipalName |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Path
Belirtilen Dosya sistemindeki alınması gereken yol. 'directory1/directory2/' biçiminde bir dizin olmalıdır.
| Tür: | String |
| Position: | 1 |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-Recurse
Alt Öğeyi özyinelemeli olarak alıp almayacaklarını gösterir. Varsayılan değer false.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |