Get-AzStorageFile
Lista diretórios e arquivos para um caminho.
Syntax
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 especificado. 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"}
Este comando lista apenas os diretórios no compartilhamento ContosoShare06. Primeiro, ele recupera arquivos e diretórios, os passa para o operador where usando o operador de pipeline e, em seguida, descarta quaisquer objetos cujo tipo não seja "AzureStorageFileDirectory".
Exemplo 2: Listar um diretório de arquivos
Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile
Este comando lista os arquivos e pastas no diretório ContosoWorkingFolder sob o compartilhamento ContosoShare06. Primeiro, ele obtém a instância de 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 que o intervalo transcorra, ele retornará um erro.
Type: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 principal. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 kilobits por segundo. O valor padrão é 10.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Especifica um contexto de Armazenamento do Azure. Para obter um contexto de armazenamento, use o cmdlet New-AzStorageContext.
Type: | IStorageContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | CloudFileDirectory |
Aliases: | CloudFileDirectory |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisAllowTrailingDot
Não permitir ponto à direita (.) para nomes de sufixo de diretório e arquivo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeExtendedInfo
Não inclua informações de arquivo estendidas, como carimbos de data/hora, ETag, atributos, permissionKey no arquivo de lista e no diretório.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerTimeoutPerRequest
Especifica o intervalo de tempo limite do lado do serviço, em segundos, para uma solicitação. Se o intervalo especificado transcorrer antes de o serviço processar a solicitação, o serviço de armazenamento retornará um erro.
Type: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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. Este objeto contém o contexto de armazenamento. Se você especificar esse parâmetro, não especifique o parâmetro Context .
Type: | CloudFileShare |
Aliases: | CloudFileShare |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareClient
O objeto ShareClient indicava o compartilhamento onde os arquivos/diretórios seriam listados.
Type: | ShareClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareDirectoryClient
O objeto ShareDirectoryClient indicava a pasta base onde os arquivos/diretórios seriam listados.
Type: | ShareDirectoryClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Saídas
Links Relacionados
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de