Get-AzDataLakeGen2ChildItem

Módulo:

Az.Storage

Enumera los subdirectorios y archivos de un directorio o raíz del sistema de archivos.

Sintaxis

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 sistema de archivos en una cuenta de Almacenamiento de Azure. 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. Una pequeña MaxCount puede limitar el recuento de elementos devueltos desde un único 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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Context

Objeto de contexto de Azure Storage

Tipo:	IStorageContext
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ContinuationToken

Token de continuación.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FetchProperty

Capture las propiedades del elemento datalake y la ACL.

Tipo:	SwitchParameter
Alias:	FetchPermission
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FileSystem

Nombre del sistema de archivos

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-MaxCount

Recuento máximo de los blobs que pueden devolver.

Tipo:	Nullable<T>[Int32]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	SwitchParameter
Alias:	UserPrincipalName
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Path

Ruta de acceso del sistema de archivos especificado que se debe recuperar. Debe ser un directorio con el formato "directory1/directory2/".

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Recurse

Indica si obtendrá recursivamente el elemento secundario. El valor predeterminado es false.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

IStorageContext

Salidas

AzureDataLakeGen2Item