Get-AzDataLakeGen2ChildItem

  • Odwołanie
Moduł:
Az.Storage

Wyświetla listę katalogów podrzędnych i plików z katalogu głównego katalogu lub systemu plików.

Składnia

Get-AzDataLakeGen2ChildItem
   [-FileSystem] <String>
   [[-Path] <String>]
   [-FetchProperty]
   [-Recurse]
   [-MaxCount <Int32>]
   [-ContinuationToken <String>]
   [-AsJob]
   [-OutputUserPrincipalName]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzDataLakeGen2ChildItem wyświetla katalogi podrzędne i pliki w katalogu lub systemie plików na koncie usługi Azure Storage. To polecenie cmdlet działa tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta magazynu. Tego rodzaju konto można utworzyć za pomocą polecenia cmdlet "New-AzStorageAccount" za pomocą polecenia "-EnableHierarchicalNamespace $true".

Przykłady

Przykład 1. Wyświetlanie listy bezpośrednich elementów podrzędnych z systemu plików

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

To polecenie wyświetla listę bezpośrednich elementów podrzędnych z systemu plików

Przykład 2: Ponowne wyświetlanie listy z katalogu i pobieranie właściwości/listy 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

To polecenie wyświetla listę bezpośrednich elementów podrzędnych z systemu plików

Przykład 3: Elementy listy cyklicznie z systemu plików w wielu partiach

$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"

W tym przykładzie użyto parametrów MaxCount i ContinuationToken do ponownego wyświetlania listy elementów z systemu plików w wielu partiach. Mały parametr MaxCount może ograniczyć liczbę elementów zwracanych z pojedynczego żądania, może pomóc w przekroczeniu limitu czasu operacji i ograniczyć użycie pamięci programu PowerShell. Pierwsze cztery polecenia przypisują wartości do zmiennych do użycia w przykładzie. Piąte polecenie określa instrukcję Do-While , która używa polecenia cmdlet Get-AzDataLakeGen2ChildItem do wyświetlania listy elementów. Instrukcja zawiera token kontynuacji przechowywany w zmiennej $Token. $Token zmienia wartość podczas uruchamiania pętli. Ostatnie polecenie używa polecenia Echo , aby wyświetlić sumę.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Obiekt kontekstu usługi Azure Storage

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

Token kontynuacji.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FetchProperty

Pobierz właściwości elementu elementu datalake i listę ACL.

Type:SwitchParameter
Aliases:FetchPermission
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileSystem

Nazwa systemu plików

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxCount

Maksymalna liczba obiektów blob, które mogą być zwracane.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputUserPrincipalName

W przypadku speicify tego parametru wartości tożsamości użytkownika zwrócone w polach właściciela i grupy każdego wpisu listy zostaną przekształcone z identyfikatorów obiektów Entra firmy Microsoft na główne nazwy użytkowników. Jeśli ten parametr nie zostanie speicify, wartości zostaną zwrócone jako identyfikatory obiektów Entra firmy Microsoft. Należy pamiętać, że identyfikatory obiektów grup i aplikacji nie są tłumaczone, ponieważ nie mają unikatowych przyjaznych nazw.

Type:SwitchParameter
Aliases:UserPrincipalName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Ścieżka w określonym systemie plików, który ma zostać pobrany. Powinien być katalogiem w formacie "directory1/directory2/".

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Recurse

Wskazuje, czy cyklicznie pobierze element podrzędny. Wartością domyślną jest false.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String

IStorageContext

Dane wyjściowe

AzureDataLakeGen2Item