Compartilhar via

Get-AzStorageFile

Módulo:
Az.Storage Module

Lista diretórios e arquivos para um caminho.

Sintaxe

ShareName (Padrão) 

Get-AzStorageFile
    [-ShareName] <String>
    [[-Path] <String>]
    [-ExcludeExtendedInfo]
    [-DisAllowTrailingDot]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Share 

Get-AzStorageFile
    [-ShareClient] <ShareClient>
    [[-Path] <String>]
    [-ExcludeExtendedInfo]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Directory 

Get-AzStorageFile
    [-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"}

Esse comando lista apenas os diretórios no compartilhamento ContosoShare06. Ele primeiro 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 encadeia para o cmdlet Get-AzStorageFile para listar o diretório.

Exemplo 3: listar arquivos e diretórios em um compartilhamento e excluir informações estendidas

Get-AzStorageFile -ShareName "ContosoShare06" -ExcludeExtendedInfo

Este comando lista os arquivos e pastas no compartilhamento ContosoShare06 e exclui informações de arquivo estendidas, como carimbos de data/hora, ETag, atributos, permissionKey no arquivo de lista e diretório. Atualmente, -ExcludeExtendedInfo será necessário para listar arquivos e diretórios do compartilhamento de arquivos NFS ou de um diretório no compartilhamento de arquivos NFS.

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 se esgote, esse cmdlet retornará um erro.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ClientTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 de CPU e 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 atenuar problemas de conexão de rede em ambientes de baixa largura de banda, como 100 quilobits por segundo. O valor padrão é 10.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Context

Especifica um contexto de Armazenamento do Azure. Para obter um contexto de armazenamento, use o cmdlet New-AzStorageContext.

Propriedades do parâmetro

Tipo:IStorageContext
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisAllowTrailingDot

Não permitir o ponto à direita (.) para sufixo de diretório e nomes de arquivo.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ShareName
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExcludeExtendedInfo

Não inclua informações de arquivo estendidas, como carimbos de data/hora, ETag, atributos, permissionKey no arquivo de lista e diretório.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Path

Especifica o caminho de uma pasta. Se você omitir o parâmetro Path , Get-AzStorageFile listará os diretórios e arquivos no diretório ou compartilhamento de arquivos especificado. Se você incluir o parâmetro Path , Get-AzStorageFile retornará uma instância de um diretório ou arquivo no caminho especificado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ServerTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do serviço, em segundos, para uma solicitação. Se o intervalo especificado ocorrer antes que o serviço processe a solicitação, o serviço de Armazenamento retornará um erro.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ServerTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ShareClient

O objeto ShareClient indicou o compartilhamento em que os arquivos/diretórios seriam listados.

Propriedades do parâmetro

Tipo:ShareClient
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Share
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ShareDirectoryClient

O objeto ShareDirectoryClient indicou a pasta base em que os arquivos/diretórios seriam listados.

Propriedades do parâmetro

Tipo:ShareDirectoryClient
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Directory
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ShareName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

ShareClient

ShareDirectoryClient

IStorageContext

Saídas

AzureStorageFile