Compartilhar via


New-AzureStorageTableSASToken

Gera um token SAS para uma tabela de Armazenamento do Azure.

Aviso

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

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

New-AzureStorageTableSASToken
   [-Name] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-StartPartitionKey <String>]
   [-StartRowKey <String>]
   [-EndPartitionKey <String>]
   [-EndRowKey <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageTableSASToken
   [-Name] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-StartPartitionKey <String>]
   [-StartRowKey <String>]
   [-EndPartitionKey <String>]
   [-EndRowKey <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzureStorageTableSASToken gera um token SAS (Assinatura de Acesso Compartilhado) para uma tabela de Armazenamento do Azure.

Exemplos

Exemplo 1: Gerar um token SAS que tenha permissões completas para uma tabela

C:\PS>New-AzureStorageTableSASToken -Name "ContosoResources" -Permission "raud"

Esse comando gera um token SAS com permissões completas para a tabela chamada ContosoResources. Esse token é para permissões de leitura, adição, atualização e exclusão.

Exemplo 2: Gerar um token SAS para um intervalo de partições

C:\PS>New-AzureStorageTableSASToken -Name "ContosoResources" -Permission "raud" -StartPartitionKey "a" -EndPartitionKey "b"

Esse comando gera um token SAS com permissões completas para a tabela chamada ContosoResources. O comando limita o token ao intervalo especificado pelos parâmetros StartPartitionKey e EndPartitionKey .

Exemplo 3: Gerar um token SAS que tenha uma política de acesso armazenada para uma tabela

C:\PS>New-AzureStorageTableSASToken -Name "ContosoResources" -Policy "ClientPolicy01"

Esse comando gera um token SAS para a tabela chamada ContosoResources. O comando especifica a política de acesso armazenada chamada ClientPolicy01.

Parâmetros

-Context

Especifica um contexto de armazenamento do Azure. Para obter um contexto de armazenamento, use o cmdlet New-AzureStorageContext.

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

-EndPartitionKey

Especifica a chave de partição do final do intervalo para o token que esse cmdlet cria.

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

-EndRowKey

Especifica a chave de linha para o final do intervalo para o token criado por esse cmdlet.

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

-ExpiryTime

Especifica quando o token SAS expira.

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 da fila completa com o token SAS.

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 o nome de uma tabela de Armazenamento do Azure. Esse cmdlet cria um token SAS para a tabela especificada por esse parâmetro.

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

-Permission

Especifica permissões para uma tabela de Armazenamento do Azure. É 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 uma política de acesso armazenada, que inclui as permissões para esse token SAS.

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

-StartPartitionKey

Especifica a chave de partição do início do intervalo para o token que esse cmdlet cria.

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

-StartRowKey

Especifica a chave de linha para o início do intervalo para o token que esse cmdlet cria.

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

-StartTime

Especifica quando o token SAS se torna válido.

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