Partilhar via

New-AzStorageBlobSASToken

  • Referência
Módulo:
Az.Storage

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

Sintaxe

New-AzStorageBlobSASToken
   [-Container] <String>
   [-Blob] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStorageBlobSASToken
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStorageBlobSASToken
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStorageBlobSASToken
   [-Container] <String>
   [-Blob] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzStorageBlobSASToken gera um token SAS (Assinatura de Acesso Compartilhado) para um blob de armazenamento do Azure.

Exemplos

Exemplo 1: Gerar um token SAS de blob com permissão de blob total

New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd

Este exemplo gera um token SAS de blob com permissão de blob total.

Exemplo 2: Gerar um token SAS de blob com tempo de vida

$StartTime = Get-Date
$EndTime = $startTime.AddHours(2.0)
New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime

Este exemplo gera um token SAS de blob com tempo de vida.

Exemplo 3: Gerar um token SAS 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-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime -Context $ctx

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

Parâmetros

-Blob

Especifica o nome do blob de armazenamento.

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

-BlobBaseClient

Objeto BlobBaseClient

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

-CloudBlob

Especifica o objeto CloudBlob. Para obter um objeto CloudBlob, use o cmdlet Get-AzStorageBlob.

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

-Confirm

Solicita confirmação antes de executar o cmdlet.

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

-Container

Especifica o nome do contêiner de armazenamento.

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

-Context

Especifica o contexto de armazenamento. Quando o contexto de armazenamento é baseado na autenticação OAuth, será gerado um token SAS de blob de identidade do usuário.

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

-EncryptionScope

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

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

-ExpiryTime

Especifica quando a assinatura de acesso compartilhado expira. Quando o contexto de armazenamento é baseado na autenticação OAuth, o tempo de expiração deve ser de 7 dias a partir da hora atual e não deve ser anterior à hora atual.

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

-Permission

Especifica as permissões para um blob 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

-WhatIf

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

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

Entradas

CloudBlob

IStorageContext

Saídas

String