Compartilhar via

Get-AzStorageFile

  • Referência
Módulo:
Az.Storage

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-AzStorageFile

Esse 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

CloudFileShare

CloudFileDirectory

IStorageContext

Saídas

AzureStorageFile