Get-AzDataLakeGen2ChildItem

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

-Context

-ContinuationToken

-DefaultProfile

-FetchProperty

-FileSystem

-MaxCount

-OutputUserPrincipalName

-Path

-Recurse

Eingaben

String

IStorageContext

Ausgaben

AzureDataLakeGen2Item