Get-AzureStorageShare
Obtém uma lista de compartilhamentos de arquivos.
Aviso
O módulo PowerShell do AzureRM 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 do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes 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 um compartilhamento de arquivos
PS C:\>Get-AzureStorageShare -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
PS C:\>Get-AzureStorageShare -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
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"
Esse 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 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] |
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-AzureStorageContext .
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 |
-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] |
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 |