Get-AzDataLakeGen2ChildItem

  • Başvuru
Modül:
Az.Storage

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

Girişler

String

IStorageContext

Çıkışlar

AzureDataLakeGen2Item