New-AzStorageShareSASToken

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

Sintaxe

SasPolicy

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

SasPermission

New-AzStorageShareSASToken
    [-ShareName] <String>
    [-Permission <String>]
    [-Protocol <String>]
    [-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 de 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.

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 usadas para comunicação com 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

-ExpiryTime

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

Propriedades do parâmetro

Tipo:

Nullable<T>[DateTime]

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

-FullUri

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

Propriedades do parâmetro

Tipo:SwitchParameter
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

-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.

Propriedades do parâmetro

Tipo:String
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

-Permission

Especifica as permissões no token para acessar o compartilhamento e os arquivos no compartilhamento. É importante observar que essa é uma cadeia de caracteres, como rwd (para Leitura, Gravação e Exclusão).

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Policy

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Protocol

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

  • HttpsOnly
  • HttpsOrHttp O valor padrão é HttpsOrHttp.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:HttpsOnly, HttpsOrHttp
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

-ShareName

Especifica o nome do compartilhamento de armazenamento.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:N, Name

Conjuntos de parâmetros

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

-StartTime

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

Propriedades do parâmetro

Tipo:

Nullable<T>[DateTime]

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

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

String

IStorageContext

Saídas

String

Observações

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