Compartilhar via

New-AzStorageShareSASToken

  • Referência
Módulo:
Az.Storage

Gerar token de Assinatura de Acesso Compartilhado para compartilhamento de Armazenamento do Azure.

Sintaxe

New-AzStorageShareSASToken
   [-ShareName] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzStorageShareSASToken
   [-ShareName] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzStorageShareSASToken gera um token de assinatura de acesso compartilhado para um compartilhamento do Armazenamento do Azure.

Exemplos

Exemplo 1: Gerar um token de assinatura de acesso compartilhado para um compartilhamento

New-AzStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"

Esse comando cria um token de assinatura de acesso compartilhado para o compartilhamento chamado ContosoShare.

Exemplo 2: Gerar vários tokens de assinatura de acesso compartilhado usando o pipeline

Get-AzStorageShare -Prefix "test" | New-AzStorageShareSASToken -Permission "rwdl"

Esse comando obtém todos os compartilhamentos de armazenamento que correspondem ao teste de prefixo. O comando os passa para o cmdlet atual usando o operador de pipeline. O cmdlet atual cria um token de acesso compartilhado para cada compartilhamento de armazenamento que tem as permissões especificadas.

Exemplo 3: Gerar um token de assinatura de acesso compartilhado que usa uma política de acesso compartilhado

New-AzStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"

Esse comando cria um token de assinatura de acesso compartilhado para o compartilhamento de armazenamento chamado ContosoShare que tem a política chamada ContosoPolicy03.

Parâmetros

-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

-ExpiryTime

Especifica a hora em que a assinatura de acesso compartilhado se torna inválida.

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

-FullUri

Indica que esse cmdlet retorna o URI de blob completo e o token de assinatura de acesso compartilhado.

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

-IPAddressOrRange

Especifica o endereço IP ou o intervalo de endereços IP dos quais aceitar solicitações, como 168.1.5.65 ou 168.1.5.60-168.1.5.70. O intervalo é inclusivo.

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

-Permission

Especifica as permissões no token para acessar o compartilhamento e os arquivos sob o compartilhamento. É importante observar que esta é uma cadeia de caracteres, como rwd (para Ler, Gravar e Excluir).

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

-Policy

Especifica a política de acesso armazenada para um compartilhamento.

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

-Protocol

Especifica o protocolo permitido para uma solicitação. Os valores aceitáveis para esse parâmetro são:

  • HttpsOnly
  • HttpsOrHttp O valor padrão é HttpsOrHttp.
Tipo:Nullable<T>[SharedAccessProtocol]
Valores aceitos:HttpsOnly, HttpsOrHttp
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShareName

Especifica o nome do compartilhamento de armazenamento.

Tipo:String
Aliases:N, Name
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StartTime

Especifica a hora em que a assinatura de acesso compartilhado se torna válida.

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

Entradas

String

IStorageContext

Saídas

String

Observações

  • Palavras-chave: comum, azure, serviços, dados, armazenamento, blob, fila, tabela