Get-AzDataLakeGen2ChildItem
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ó funciona 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 $superuserEste comando lista os subitens diretos de um sistema de arquivos
Exemplo 2: Listar recursivamente a partir 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 $superuserEste 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 de 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 muda de 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
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Context
Objeto de contexto de armazenamento do Azure
| Tipo: | IStorageContext |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-ContinuationToken
Token de continuação.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-FetchProperty
Buscar as propriedades do item datalake e a ACL.
| Tipo: | SwitchParameter |
| Aliases: | FetchPermission |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-FileSystem
Nome do sistema de arquivos
| Tipo: | String |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-MaxCount
A contagem máxima das bolhas que podem retornar.
| Tipo: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OutputUserPrincipalName
Se especificar 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 especificar esse parâmetro, 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Path
O caminho no sistema de arquivos especificado que deve ser recuperado. Deve ser um diretório, no formato 'directory1/directory2/'.
| Tipo: | String |
| Position: | 1 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Recurse
Indica se obterá recursivamente o Item Filho. O padrão é false.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
Entradas
Saídas
Azure PowerShell