Get-AzDataLakeGen2ChildItem

Referenz

Modul:: Az.Storage

Listet Unterverzeichnisse und Dateien aus einem Verzeichnis- oder Dateisystemstamm auf.

Syntax

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

Beschreibung

Das Cmdlet "Get-AzDataLakeGen2ChildItem " listet Unterverzeichnisse und Dateien in einem Verzeichnis oder Dateisystem in einem Azure-Speicherkonto auf. Dieses Cmdlet funktioniert nur, wenn der hierarchische Namespace für das Speicherkonto aktiviert ist. Diese Art von Konto kann mit dem Cmdlet "New-AzStorageAccount" mit "-EnableHierarchicalNamespace $true" erstellt werden.

Beispiele

Beispiel 1: Auflisten der direkten Unterelemente aus einem Dateisystem

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

Dieser Befehl listet die direkten Unterelemente aus einem Dateisystem auf.

Beispiel 2: Rekursiv aus einem Verzeichnis auflisten und Eigenschaften/ACL abrufen

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

Dieser Befehl listet die direkten Unterelemente aus einem Dateisystem auf.

Beispiel 3: Rekursives Auflisten von Elementen aus einem Dateisystem in mehreren Batches

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

In diesem Beispiel werden die Parameter MaxCount und ContinuationToken verwendet, um Elemente rekursiv aus einem Dateisystem in mehreren Batches auflisten. Ein kleiner MaxCount kann die elemente einschränken, die von einem einzelnen Requst zurückgegeben werden, kann beim Ausfallfehler beim Vorgang helfen und die Speicherauslastung von PowerShell einschränken. Die ersten vier Befehle weisen Variablen Werte zu, die im Beispiel verwendet werden sollen. Der fünfte Befehl gibt eine Do-While-Anweisung an, die das Cmdlet Get-AzDataLakeGen2ChildItem zum Auflisten von Elementen verwendet. Die Anweisung enthält das in der $Token Variable gespeicherte Fortsetzungstoken. $Token ändert den Wert, während die Schleife ausgeführt wird. Der letzte Befehl verwendet den Befehl "Echo ", um die Summe anzuzeigen.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

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

-Context

Azure Storage Context-Objekt

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

-ContinuationToken

Fortsetzungstoken.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-FetchProperty

Ruft die Datalake-Elementeigenschaften und ACL ab.

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

-FileSystem

Dateisystemname

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

-MaxCount

Die maximale Anzahl der Blobs, die zurückgegeben werden können.

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

-OutputUserPrincipalName

Wenn Sie diesen Parameter speicifizieren, werden die im Besitzer- und Gruppenfeld jedes Listeneintrags zurückgegebenen Benutzeridentitätswerte von Microsoft Entra-Objekt-IDs in Benutzerprinzipalnamen transformiert. Wenn dieser Parameter nicht angegeben wird, werden die Werte als Microsoft Entra-Objekt-IDs zurückgegeben. Beachten Sie, dass Gruppen- und Anwendungsobjekt-IDs nicht übersetzt werden, da sie keine eindeutigen Anzeigenamen enthalten.

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

-Path

Der Pfad im angegebenen Dateisystem, das abgerufen werden soll. Sollte ein Verzeichnis im Format "directory1/directory2/" sein.

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

-Recurse

Gibt an, ob das untergeordnete Element rekursiv abgerufen wird. Die Standardeinstellung ist „false“.

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

Eingaben

String

IStorageContext

Ausgaben

AzureDataLakeGen2Item

Share via