Get-AzStorageShare
Obtém uma lista de compartilhamentos de arquivos.
Syntax
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 arquivo 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 buscar propriedades de compartilhamento 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 oferece suporte a OAuth. Portanto, para obter o objeto de compartilhamento com autenticação OAuth deve 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 tentará novamente a solicitação. Se esse cmdlet não receber uma resposta bem-sucedida antes que o intervalo transcorra, ele retornará um erro.
Type: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 padrão é 10.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Especifica um contexto de Armazenamento do Azure. Para obter um contexto, use o cmdlet New-AzStorageContext .
Type: | IStorageContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeDeleted
Incluir compartilhamentos excluídos, por padrão, obter compartilhamento não incluirá compartilhamentos excluídos
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerTimeoutPerRequest
Especifica a duração do período de tempo limite para a parte do servidor de uma solicitação.
Type: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipGetProperty
Especifique esse parâmetro para gerar apenas um objeto de compartilhamento local, sem obter propriedades de compartilhamento do servidor.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SnapshotTime
SnapshotTime do instantâneo de compartilhamento de arquivos a ser recebido.
Type: | Nullable<T>[DateTimeOffset] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Saídas
Links Relacionados
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de