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