Get-AzDataLakeGen2ChildItem

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-AzStorageAccount" 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 , birden çok toplu işlemde dosya sisteminden özyinelemeli olarak öğeleri listelemek için MaxCount ve ContinuationToken parametreleri kullanılır. Küçük bir MaxCount tek bir requst'tan döndürülen öğeleri sınırlandırabilir, 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 Do-While deyimini 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

-Context

-ContinuationToken

-DefaultProfile

-FetchProperty

-FileSystem

-MaxCount

-OutputUserPrincipalName

-Path

-Recurse

Girişler

String

IStorageContext

Çıkışlar

AzureDataLakeGen2Item