Get-AzDataLakeGen2ChildItem

Referência

Módulo:: Az.Storage

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

Sintaxe

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 pequeno MaxCount pode limitar a contagem de itens retornados de um único requst, 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 usados 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 conforme o loop é executado. O comando final usa o comando Echo para exibir o total.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Context

Objeto de contexto de armazenamento do Azure

Tipo:	IStorageContext
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ContinuationToken

Token de continuação.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-FetchProperty

Busque as propriedades do item datalake e a ACL.

Tipo:	SwitchParameter
Aliases:	FetchPermission
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-FileSystem

Nome do FileSystem

Tipo:	String
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-MaxCount

A contagem máxima dos blobs que podem ser retornados.

Tipo:	Nullable<T>[Int32]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-OutputUserPrincipalName

Se esse parâmetro for selecionado, 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 de Entidade de Usuário. Se não fizer isso, os valores serão retornados como IDs de Objeto do Microsoft Entra. Observe que as IDs de objeto de grupo e aplicativo não são traduzidas porque não têm nomes amigáveis exclusivos.

Tipo:	SwitchParameter
Aliases:	UserPrincipalName
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Path

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

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Recurse

Indica se obterá o Item Filho de forma recursiva. O padrão é false.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

String

IStorageContext

Saídas

AzureDataLakeGen2Item

Compartilhar via