Get-AzDataLakeGen2ChildItem

Référence

Module:: Az.Storage

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

Syntax

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 Stockage. Ce type de compte peut être créé en exécutant l’applet de commande « New-Az Stockage Account » 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

objet de contexte Stockage Azure

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

-ContinuationToken

Jeton de continuation.

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

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	FetchPermission
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FileSystem

Nom du système de fichiers

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

-MaxCount

Nombre maximal d’objets blob pouvant retourner.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	UserPrincipalName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Recurse

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

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

Entrées

String

IStorageContext

Sorties

AzureDataLakeGen2Item