Partager via


Get-AzDataLakeGen2ChildItem

Répertorie les sous-répertoires et les fichiers à partir d’une racine de répertoire ou de système de fichiers.

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

Exécuter l’applet de commande en arrière-plan

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Context

objet de contexte Stockage Azure

Type:IStorageContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ContinuationToken

Jeton de continuation.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FetchProperty

Récupérez les propriétés de l’élément datalake et la liste de contrôle d’accès.

Type:SwitchParameter
Alias:FetchPermission
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FileSystem

Nom du système de fichiers

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-MaxCount

Nombre maximal d’objets blob pouvant retourner.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OutputUserPrincipalName

Si vous spécifiez ce paramètre, les valeurs d’identité utilisateur retournées dans les champs propriétaire et groupe de chaque entrée de liste sont transformées des ID d’objet Microsoft Entra en noms d’utilisateur principal. Si ce paramètre n’est pas spécifié, les valeurs sont retournées en tant qu’ID d’objet Microsoft Entra. Notez que les ID d’objet de groupe et d’application ne sont pas traduits, car ils n’ont pas de noms conviviaux uniques.

Type:SwitchParameter
Alias:UserPrincipalName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Chemin d’accès dans le système de fichiers spécifié qui doit être récupéré. Doit être un répertoire, au format « directory1/directory2/ ».

Type:String
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Recurse

Indique si l’élément enfant est récursif. La valeur par défaut est false.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

IStorageContext

Sorties

AzureDataLakeGen2Item