Partilhar via

New-AzureStorageContainerSASToken

  • Referência
Módulo:
Azure.Storage

Gera um token SAS para um contentor de armazenamento do Azure.

Aviso

O módulo AzureRM do PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

Description

O cmdlet New-AzureStorageContainerSASToken gera um token SAS (Assinatura de Acesso Compartilhado) para um contêiner de armazenamento do Azure.

Exemplos

Exemplo 1: Gerar um token SAS de contêiner com permissão de contêiner completo

PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Permission rwdl

Este exemplo gera um token SAS de contêiner com permissão de contêiner completo.

Exemplo 2: Gerar vários tokens SAS de contêiner por pipeline

PS C:\>Get-AzureStorageContainer -Container test* | New-AzureStorageContainerSASToken -Permission rwdl

Este exemplo gera vários tokens SAS de contêiner usando o pipeline.

Exemplo 3: Gerar token SAS de contêiner com política de acesso compartilhado

PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Policy "PolicyName"

Este exemplo gera um token SAS de contêiner com política de acesso compartilhado.

Parâmetros

-Context

Especifica um contexto de armazenamento do Azure. Você pode criá-lo usando o cmdlet New-AzureStorageContext.

Tipo:IStorageContext
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ExpiryTime

Especifica o momento em que a assinatura de acesso compartilhado se torna inválida. Se o utilizador definir a hora de início, mas não a hora de expiração, a hora de expiração é definida para a hora de início mais uma hora. Se nem a hora de início nem a hora de expiração forem especificadas, a hora de expiração é definida para a hora atual mais uma hora.

Tipo:Nullable<T>[DateTime]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FullUri

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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. A gama é inclusiva.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica um nome de contêiner de armazenamento do Azure.

Tipo:String
Aliases:N, Container
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Permission

Especifica permissões para um contêiner de armazenamento. É importante notar que esta é uma cadeia de caracteres, como rwd (para Ler, Escrever e Excluir).

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Policy

Especifica uma Política de Acesso Armazenado do Azure.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Protocol

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

  • Disponível em: https...
  • HttpsOrHttp O valor padrão é HttpsOrHttp.
Tipo:Nullable<T>[SharedAccessProtocol]
Valores aceites:HttpsOnly, HttpsOrHttp
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StartTime

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

Tipo:Nullable<T>[DateTime]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

IStorageContext

Saídas

String