New-AzStorageContainerSASToken

  • Referência
Módulo:
Az.Storage

Gera um token SAS para um contêiner de armazenamento do Azure.

Sintaxe

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

Description

O cmdlet New-AzStorageContainerSASToken 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 completa

New-AzStorageContainerSASToken -Name "Test" -Permission rwdl

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

Exemplo 2: Gerar token SAS de vários contêineres por pipeline

Get-AzStorageContainer -Container test* | New-AzStorageContainerSASToken -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

New-AzStorageContainerSASToken -Name "Test" -Policy "PolicyName"

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

Exemplo 3: Gerar um token SAS de contêiner de identidade de usuário com contexto de armazenamento baseado na autenticação OAuth

$ctx = New-AzStorageContext -StorageAccountName $accountName -UseConnectedAccount
$StartTime = Get-Date
$EndTime = $startTime.AddDays(6)
New-AzStorageContainerSASToken -Name "ContainerName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime -context $ctx

Este exemplo gera um token SAS do contêiner de identidade do usuário com contexto de armazenamento baseado na autenticação OAuth

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-Context

Especifica um contexto de armazenamento do Azure. Você pode criá-lo usando o cmdlet New-AzStorageContext. Quando o contexto de armazenamento é baseado na autenticação OAuth, o irá gerar um token SAS do contêiner de identidade do usuário.

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

-EncryptionScope

Escopo de criptografia a ser usado ao enviar solicitações autorizadas com esse URI SAS.

Tipo:String
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. Se o usuário definir a hora de início, mas não a hora de expiração, a hora de expiração será definida como 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 será definida como a hora atual mais uma hora. Quando o contexto de armazenamento é baseado na autenticação OAuth, o tempo de expiração deve ser em 7 dias a partir do horário atual e não deve ser anterior ao tempo atual.

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

-Name

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

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

-Permission

Especifica permissões para um contêiner de armazenamento. É importante observar que esta é uma cadeia de caracteres, como rwd (para Ler, Gravar e Excluir). As permissões com suporte para o tipo de recurso de contêiner são descritas aqui.

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

-Policy

Especifica uma política de acesso armazenado do Azure.

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

-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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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