Get-AzDataLakeGen2ChildItem

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ła MaxCount może ograniczyć liczbę elementów zwróconych 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

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Context

Obiekt kontekstu usługi Azure Storage

Typ:	IStorageContext
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-ContinuationToken

Token kontynuacji.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliasy:	AzureRmContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FetchProperty

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

Typ:	SwitchParameter
Aliasy:	FetchPermission
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FileSystem

Nazwa systemu plików

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-MaxCount

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

Typ:	Nullable<T>[Int32]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	SwitchParameter
Aliasy:	UserPrincipalName
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Path

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

Typ:	String
Position:	1
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Recurse

Wskazuje, czy cyklicznie pobierze element podrzędny. Wartość domyślna to false.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

String

IStorageContext

Dane wyjściowe

AzureDataLakeGen2Item