Get-AzDataLakeGen2ChildItem

Syntaxe

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

Description

L’applet de commande Get-AzDataLakeGen2ChildItem répertorie les sous-répertoires et fichiers d’un répertoire ou d’un système de fichiers dans un compte de stockage Azure. Cette applet de commande fonctionne uniquement si l’espace de noms hiérarchique est activé pour le compte de stockage. Ce type de compte peut être créé en exécutant l’applet de commande « New-AzStorageAccount » avec « -EnableHierarchicalNamespace $true ».

Exemples

Exemple 1 : Répertorier les sous-éléments directs d’un système de fichiers

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

Cette commande répertorie les sous-éléments directs d’un système de fichiers

Exemple 2 : Répertorier de manière récursive à partir d’un répertoire et récupérer des propriétés/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

Cette commande répertorie les sous-éléments directs d’un système de fichiers

Exemple 3 : Répertorier les éléments de manière récursive à partir d’un système de fichiers dans plusieurs lots

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

Cet exemple utilise les paramètres MaxCount et ContinuationToken pour répertorier les éléments de manière récursive à partir d’un système de fichiers dans plusieurs lots. Un petit MaxCount peut limiter le nombre d’éléments retournés à partir d’un requst unique, peut aider à effectuer une erreur d’expiration de l’opération et limiter l’utilisation de la mémoire de PowerShell. Les quatre premières commandes attribuent des valeurs à des variables à utiliser dans l’exemple. La cinquième commande spécifie une instruction Do-While qui utilise l’applet de commande Get-AzDataLakeGen2ChildItem pour répertorier les éléments. L’instruction inclut le jeton de continuation stocké dans la variable $Token. $Token modifie la valeur lors de l’exécution de la boucle. La commande finale utilise la commande Echo pour afficher le total.

Paramètres

-AsJob

-Context

-ContinuationToken

-DefaultProfile

-FetchProperty

-FileSystem

-MaxCount

-OutputUserPrincipalName

-Path

-Recurse

Entrées

String

IStorageContext

Sorties

AzureDataLakeGen2Item