Get-AzDataLakeGen2ChildItem

  • Referência
Módulo:
Az.Storage

Lista subdiretórios e arquivos de um diretório ou raiz do sistema de arquivos.

Syntax

Get-AzDataLakeGen2ChildItem
   [-FileSystem] <String>
   [[-Path] <String>]
   [-FetchProperty]
   [-Recurse]
   [-MaxCount <Int32>]
   [-ContinuationToken <String>]
   [-AsJob]
   [-OutputUserPrincipalName]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzDataLakeGen2ChildItem lista subdiretórios e arquivos em um diretório ou sistema de arquivos em uma conta de armazenamento do Azure. Esse cmdlet só funcionará se o Namespace Hierárquico estiver habilitado para a conta de Armazenamento. Esse tipo de conta pode ser criado executando o cmdlet "New-AzStorageAccount" com "-EnableHierarchicalNamespace $true".

Exemplos

Exemplo 1: Listar os subitens diretos de um sistema de arquivos

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 lista os subitens diretos de um sistema de arquivos

Exemplo 2: Listar recursivamente de um diretório e buscar Propriedades/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 lista os subitens diretos de um sistema de arquivos

Exemplo 3: Listar itens recursivamente de um sistema de arquivos em vários 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"

Este exemplo usa os parâmetros MaxCount e ContinuationToken para listar itens recursivamente de um sistema de arquivos em vários lotes. Um MaxCount pequeno pode limitar a contagem de itens retornados de um único requisito, pode ajudar no erro de tempo limite da operação e limitar o uso de memória do Powershell. Os quatro primeiros comandos atribuem valores a variáveis a serem usadas no exemplo. O quinto comando especifica uma instrução Do-While que usa o cmdlet Get-AzDataLakeGen2ChildItem para listar itens. A instrução inclui o token de continuação armazenado na variável $Token. $Token altera o valor à medida que o loop é executado. O comando final usa o comando Echo para exibir o total.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

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

-Context

Objeto de contexto do Armazenamento do Azure

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

-ContinuationToken

Token de continuação.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FetchProperty

Busque as propriedades do item datalake e a ACL.

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

-FileSystem

Nome do sistema de arquivos

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

-MaxCount

A contagem máxima dos blobs que podem retornar.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputUserPrincipalName

Se speicify esse parâmetro, os valores de identidade do usuário retornados nos campos proprietário e grupo de cada entrada de lista serão transformados de IDs de objeto do Microsoft Entra para nomes principais de usuário. Se não speicify esse parâmetro, os valores serão retornados como Microsoft Entra Object IDs. Observe que as IDs de objeto de grupo e aplicativo não são traduzidas porque não têm nomes amigáveis exclusivos.

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

-Path

O caminho no sistema de arquivos especificado que deve ser recuperado. Deve ser um diretório, no formato 'directory1/directory2/'.

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

-Recurse

Indica se obterá recursivamente o Item Filho. O padrão é false.

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

Entradas

String

IStorageContext

Saídas

AzureDataLakeGen2Item