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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Context

Azure Storage Context-Objekt

Typ:	IStorageContext
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ContinuationToken

Fortsetzungstoken.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliase:	AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-FetchProperty

Ruft die Datalake-Elementeigenschaften und ACL ab.

Typ:	SwitchParameter
Aliase:	FetchPermission
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-FileSystem

Dateisystemname

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-MaxCount

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

Typ:	Nullable<T>[Int32]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	SwitchParameter
Aliase:	UserPrincipalName
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Path

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

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Recurse

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

IStorageContext

Ausgaben

AzureDataLakeGen2Item

Freigeben über