Get-AzureStorageFile
Lista diretórios e arquivos para um caminho.
Aviso
O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.
Sintaxe
Get-AzureStorageFile
[-ShareName] <String>
[[-Path] <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzureStorageFile
[-Share] <CloudFileShare>
[[-Path] <String>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzureStorageFile
[-Directory] <CloudFileDirectory>
[[-Path] <String>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Description
O cmdlet Get-AzureStorageFile 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
PS C:\>Get-AzureStorageFile -ShareName "ContosoShare06" | where {$_.GetType().Name -eq "CloudFileDirectory"}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 é "CloudFileDirectory".
Exemplo 2: Listar um diretório de arquivos
PS C:\> Get-AzureStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzureStorageFileEsse 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-AzureStorageFile 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] |
| 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-AzureStorageContext.
| 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-AzureStorageDirectory. Você também pode usar o cmdlet Get-AzureStorageFile para obter um diretório.
| Tipo: | CloudFileDirectory |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Path
Especifica o caminho de uma pasta. Se você omitir o parâmetro Path , Get-AzureStorageFile listará os diretórios e arquivos no compartilhamento de arquivos ou diretório especificado. Se você incluir o parâmetro Path , Get-AzureStorageFile 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] |
| 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-AzureStorageShare. Esse objeto contém o contexto Storage. Se você especificar esse parâmetro, não especifique o parâmetro Context .
| Tipo: | CloudFileShare |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| 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
Parâmetros: Compartilhar (ByValue)
Parâmetros: Diretório (ByValue)