Compartilhar via

Get-AzStorageShare

  • Referência
Módulo:
Az.Storage

Obtém uma lista de compartilhamentos de arquivos.

Sintaxe

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

Description

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

Exemplos

Exemplo 1: Obter um compartilhamento de arquivos

Get-AzStorageShare -Name "ContosoShare06"

Esse 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

Get-AzStorageShare -Prefix "Contoso"

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

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

$Context = New-AzStorageContext -Local
Get-AzStorageShare -Context $Context

O primeiro comando usa o cmdlet New-AzStorageContext 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

Get-AzStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"

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

Exemplo 5: Obter um objeto de compartilhamento de arquivos sem propriedades de compartilhamento de busca com autenticação OAuth.

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
$share = Get-AzStorageShare -Name "ContosoShare06" -SkipGetProperty -Context $ctx

Esse comando obtém um instantâneo de compartilhamento de arquivos sem obter propriedades de compartilhamento com autenticação OAuth. Obter propriedades de compartilhamento com autenticação OAuth falhará, pois a API não dá suporte a OAuth. Portanto, para obter o objeto de compartilhamento com autenticação OAuth, é necessário ignorar as propriedades de compartilhamento de busca.

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 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 reduzir 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, 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

-IncludeDeleted

Incluir compartilhamentos excluídos, por padrão, obter compartilhamento não incluirá compartilhamentos excluídos

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome do compartilhamento de arquivos. Esse 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
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Prefix

Especifica o prefixo para compartilhamentos de arquivos. Esse 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
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServerTimeoutPerRequest

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

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

-SkipGetProperty

Especifique esse parâmetro para gerar apenas um objeto de compartilhamento local, sem obter propriedades de compartilhamento do servidor.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SnapshotTime

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

Tipo:Nullable<T>[DateTimeOffset]
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

IStorageContext

Saídas

AzureStorageFileShare