Compartilhar via

Get-AzStorageShare

Módulo:
Az.Storage Module

Obtém uma lista de compartilhamentos de arquivos.

Sintaxe

MatchingPrefix (Padrão) 

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

Specific 

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 arquivo 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 a Contoso.

Exemplo 3: Obter todos os compartilhamentos de arquivo 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 armazena esse objeto de contexto na variável $Context. O segundo comando obtém os compartilhamentos de arquivo para o objeto de contexto armazenado em $Context.

Exemplo 4: obter um instantâneo de compartilhamento de arquivo com o 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 arquivo com um nome de compartilhamento específico e SnapshotTime.

Exemplo 5: obter um objeto de compartilhamento de arquivo sem buscar propriedades de compartilhamento com a 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 a autenticação OAuth. Obter propriedades de compartilhamento com a autenticação OAuth falhará, pois a API não dá suporte ao OAuth. Portanto, para obter o objeto de compartilhamento com a autenticação OAuth, ignore 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 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 reduzir 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, 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

-IncludeDeleted

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

MatchingPrefix
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 arquivo que não existe.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Prefix

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-ServerTimeoutPerRequest

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

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

-SkipGetProperty

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-SnapshotTime

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

Propriedades do parâmetro

Tipo:

Nullable<T>[DateTimeOffset]

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

Conjuntos de parâmetros

Specific
Cargo:1
Obrigatório:False
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

IStorageContext

Saídas

AzureStorageFileShare