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ó 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 $superuserEste 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 $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 uma única solicitação, pode ajudar no erro de tempo limite de operação e limitar o uso de memória do Powershell. Os primeiros quatro 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 Eco 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 do 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 a 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 do 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 sistema de arquivos
| 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 retornar.
| 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 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 em 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 os IDs de objeto de grupo e aplicativo não são convertidos 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 'diretório1/diretório2/'.
| 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á recursivamente o Item Filho. 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
Saídas
Azure PowerShell