Get-AzDataLakeGen2ChildItem
Enumera los subdirectorios y archivos de un directorio o raíz del sistema de archivos.
Syntax
Get-AzDataLakeGen2ChildItem
[-FileSystem] <String>
[[-Path] <String>]
[-FetchProperty]
[-Recurse]
[-MaxCount <Int32>]
[-ContinuationToken <String>]
[-AsJob]
[-OutputUserPrincipalName]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
El cmdlet Get-AzDataLakeGen2ChildItem enumera los sub directorios y archivos de un directorio o filesystem en una cuenta de Azure Storage. Este cmdlet solo funciona si el espacio de nombres jerárquico está habilitado para la cuenta de almacenamiento. Este tipo de cuenta se puede crear mediante la ejecución del cmdlet "New-AzStorageAccount" con "-EnableHierarchicalNamespace $true".
Ejemplos
Ejemplo 1: Enumeración de los elementos secundarios directos de un sistema de archivos
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
Este comando enumera los elementos secundarios directos de un sistema de archivos.
Ejemplo 2: Enumerar de forma recursiva desde un directorio y capturar propiedades/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
Este comando enumera los elementos secundarios directos de un sistema de archivos.
Ejemplo 3: Enumerar elementos recursivamente desde un sistema de archivos en varios lotes
$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"
En este ejemplo se usan los parámetros MaxCount y ContinuationToken para enumerar elementos de forma recursiva desde un sistema de archivos en varios lotes. Un valor MaxCount pequeño puede limitar el recuento de elementos devueltos desde una sola requst, puede ayudar en el tiempo de espera de la operación y limitar el uso de memoria de PowerShell. Los cuatro primeros comandos asignan valores a variables que se usarán en el ejemplo. El quinto comando especifica una instrucción Do-While que usa el cmdlet Get-AzDataLakeGen2ChildItem para enumerar elementos. La instrucción incluye el token de continuación almacenado en la variable $Token. $Token cambia el valor a medida que se ejecuta el bucle. El comando final usa el comando Echo para mostrar el total.
Parámetros
-AsJob
Ejecución del cmdlet en segundo plano
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Objeto de contexto de Azure Storage
Type: | IStorageContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContinuationToken
Token de continuación.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FetchProperty
Capture las propiedades del elemento datalake y la ACL.
Type: | SwitchParameter |
Aliases: | FetchPermission |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileSystem
Nombre del sistema de archivos
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaxCount
Recuento máximo de los blobs que pueden devolver.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputUserPrincipalName
Si especifica este parámetro, los valores de identidad de usuario devueltos en los campos propietario y de grupo de cada entrada de lista se transformarán de identificadores de objeto de Microsoft Entra a nombres principales de usuario. Si no especifica este parámetro, los valores se devolverán como identificadores de objeto de Microsoft Entra. Tenga en cuenta que los identificadores de objeto de grupo y aplicación no se traducen porque no tienen nombres descriptivos únicos.
Type: | SwitchParameter |
Aliases: | UserPrincipalName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Ruta de acceso del sistema de archivos especificado que se debe recuperar. Debe ser un directorio con el formato "directory1/directory2/".
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Recurse
Indica si obtendrá recursivamente el elemento secundario. El valor predeterminado es false.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Salidas
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de