Get-AzStorageFile
Lista diretórios e arquivos para um caminho.
Sintaxe
Get-AzStorageFile
[-ShareName] <String>
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzStorageFile
[-Share] <CloudFileShare>
[-ShareClient <ShareClient>]
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzStorageFile
[-Directory] <CloudFileDirectory>
[-ShareDirectoryClient <ShareDirectoryClient>]
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Description
O cmdlet Get-AzStorageFile lista diretórios e arquivos para o compartilhamento ou diretório que você especificar. Especifique o parâmetro Path para obter uma instância de um diretório ou arquivo no caminho especificado. Esse cmdlet retorna objetos AzureStorageFile e AzureStorageDirectory . Você pode usar a propriedade IsDirectory para distinguir entre pastas e arquivos.
Exemplos
Exemplo 1: Listar diretórios em um compartilhamento
Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}Esse comando lista apenas os diretórios no compartilhamento ContosoShare06. Primeiro, ele recupera arquivos e diretórios, passa-os para o operador where usando o operador de pipeline e, em seguida, descarta todos os objetos cujo tipo não é "AzureStorageFileDirectory".
Exemplo 2: Listar um diretório de arquivos
Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFileEsse comando lista os arquivos e pastas no diretório ContosoWorkingFolder no compartilhamento ContosoShare06. Primeiro, ele obtém a instância do diretório e, em seguida, a canaliza para o cmdlet Get-AzStorageFile para listar o diretório.
Parâmetros
-ClientTimeoutPerRequest
Especifica o intervalo de tempo limite do lado do cliente, em segundos, para uma solicitação de serviço. Se a chamada anterior falhar dentro do intervalo especificado, esse cmdlet repetirá a solicitação. Se esse cmdlet não receber uma resposta bem-sucedida antes do término do intervalo, ele retornará um erro.
| Tipo: | Nullable<T>[Int32] |
| Aliases: | ClientTimeoutPerRequestInSeconds |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ConcurrentTaskCount
Especifica o máximo de chamadas de rede simultâneas. Você pode usar esse parâmetro para limitar a simultaneidade para limitar o uso local da CPU e da largura de banda especificando o número máximo de chamadas de rede simultâneas. O valor especificado é uma contagem absoluta e não é multiplicado pela contagem de núcleos. Esse parâmetro pode ajudar a mitigar problemas de conexão de rede em ambientes de baixa largura de banda, como 100 kilobits por segundo. O valor padrão é 10.
| Tipo: | Nullable<T>[Int32] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Context
Especifica um contexto de Armazenamento do Azure. Para obter um contexto de armazenamento, use o cmdlet New-AzStorageContext.
| Tipo: | IStorageContext |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| 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 |
-Directory
Especifica uma pasta como um objeto CloudFileDirectory . Esse cmdlet obtém a pasta especificada por esse parâmetro. Para obter um diretório, use o cmdlet New-AzStorageDirectory. Você também pode usar o cmdlet Get-AzStorageFile para obter um diretório.
| Tipo: | CloudFileDirectory |
| Aliases: | CloudFileDirectory |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-DisAllowTrailingDot
Não permita o ponto final (.) para sufixar nomes de diretórios e arquivos.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ExcludeExtendedInfo
Não inclui informações de arquivo estendidas, como carimbos de data/hora, ETag, atributos, permissionKey no arquivo de lista e diretório.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Path
Especifica o caminho de uma pasta. Se você omitir o parâmetro Path , Get-AzStorageFile listará os diretórios e arquivos no compartilhamento de arquivos ou diretório especificado. Se você incluir o parâmetro Path , Get-AzStorageFile retornará uma instância de um diretório ou arquivo no caminho especificado.
| Tipo: | String |
| Cargo: | 1 |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ServerTimeoutPerRequest
Especifica o intervalo de tempo limite do lado do serviço, em segundos, para uma solicitação. Se o intervalo especificado decorrer antes que o serviço processe a solicitação, o serviço de armazenamento retornará um erro.
| Tipo: | Nullable<T>[Int32] |
| Aliases: | ServerTimeoutPerRequestInSeconds |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Share
Especifica um objeto CloudFileShare . Esse cmdlet obtém um arquivo ou diretório do compartilhamento de arquivos especificado por esse parâmetro. Para obter um objeto CloudFileShare , use o cmdlet Get-AzStorageShare. Esse objeto contém o contexto Storage. Se você especificar esse parâmetro, não especifique o parâmetro Context .
| Tipo: | CloudFileShare |
| Aliases: | CloudFileShare |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ShareClient
ShareClient indicava o compartilhamento em que os arquivos/diretórios seriam listados.
| Tipo: | ShareClient |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ShareDirectoryClient
ShareDirectoryClient indicava a pasta base onde os arquivos/diretórios seriam listados.
| Tipo: | ShareDirectoryClient |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ShareName
Especifica o nome do compartilhamento de arquivos. Esse cmdlet obtém um arquivo ou diretório do compartilhamento de arquivos especificado por esse parâmetro.
| Tipo: | String |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
Saídas
Links Relacionados
Azure PowerShell