Partilhar via

Get-AzureStorageShare

  • Referência
Módulo:
Azure.Storage

Obtém uma lista de compartilhamentos de arquivos.

Aviso

O módulo AzureRM do PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

Get-AzureStorageShare
   [[-Prefix] <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageShare
   [-Name] <String>
   [[-SnapshotTime] <DateTimeOffset>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

O cmdlet Get-AzureStorageShare obtém uma lista de compartilhamentos de arquivos para uma conta de armazenamento.

Exemplos

Exemplo 1: Obter uma partilha de ficheiros

PS C:\>Get-AzureStorageShare -Name "ContosoShare06"

Este comando obtém o compartilhamento de arquivos chamado ContosoShare06.

Exemplo 2: Obter todos os compartilhamentos de arquivos que começam com uma cadeia de caracteres

PS C:\>Get-AzureStorageShare -Prefix "Contoso"

Este comando obtém todos os compartilhamentos de arquivos com nomes que começam com Contoso.

Exemplo 3: Obter todos os compartilhamentos de arquivos em um contexto especificado

PS C:\>$Context = New-AzureStorageContext -Local
PS C:\> Get-AzureStorageShare -Context $Context

O primeiro comando usa o cmdlet New-AzureStorageContext para criar um contexto usando o parâmetro Local e, em seguida, armazena esse objeto de contexto na variável $Context. O segundo comando obtém os compartilhamentos de arquivos para o objeto de contexto armazenado no $Context.

Exemplo 4: Obter um instantâneo de compartilhamento de arquivos com nome de compartilhamento específico e SnapshotTime

PS C:\>Get-AzureStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"

Este comando obtém um instantâneo de compartilhamento de arquivos com nome de compartilhamento específico e SnapshotTime.

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 no intervalo especificado, esse cmdlet tentará novamente a solicitação. Se este cmdlet não receber uma resposta bem-sucedida antes do intervalo passar, ele retornará um erro.

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 predefinido é 10.

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Context

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

Tipo:IStorageContext
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome do compartilhamento de arquivos. Este cmdlet obtém o compartilhamento de arquivos especificado por esse parâmetro ou nada se você especificar o nome de um compartilhamento de arquivos que não existe.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Prefix

Especifica o prefixo para compartilhamentos de arquivos. Este cmdlet obtém compartilhamentos de arquivos que correspondem ao prefixo especificado por esse parâmetro ou nenhum compartilhamento de arquivos se nenhum compartilhamento de arquivos corresponder ao prefixo especificado.

Tipo:String
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServerTimeoutPerRequest

Especifica o período de tempo limite para a parte do servidor de uma solicitação.

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SnapshotTime

SnapshotTime do instantâneo de compartilhamento de arquivos a ser recebido.

Tipo:Nullable<T>[DateTimeOffset]
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

IStorageContext

Saídas

CloudFileShare