New-AzStorageContainerSASToken
Gera um token SAS para um contêiner de armazenamento do Azure.
Sintaxe
SasPolicy
New-AzStorageContainerSASToken
[-Name] <String>
-Policy <String>
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-EncryptionScope <String>]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SasPermission
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
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 vários tokens SAS de contêiner por pipeline
Get-AzStorageContainer -Container test* | New-AzStorageContainerSASToken -Permission rwdl
Este exemplo gera vários tokens SAS de contêiner usando o pipeline.
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 de contêiner de Identidade de Usuário com contexto de armazenamento baseado na autenticação OAuth
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: cf
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
-Context
Especifica um contexto de armazenamento do Azure.
Você pode criá-lo usando o cmdlet New-AzStorageContext.
Quando o contexto de armazenamento for baseado na autenticação OAuth, gerará um token SAS de contêiner de Identidade de Usuário.
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 usados para a comunicação com o 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
-EncryptionScope
Escopo de criptografia a ser usado ao enviar solicitações autorizadas com esse URI SAS.
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
-ExpiryTime
Especifica o momento 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, o tempo de expiração será definido como a hora atual mais uma hora.
Quando o contexto de armazenamento é baseado na autenticação OAuth, o tempo de expiração deve estar em 7 dias a partir do horário atual e não deve ser anterior ao horário atual.
Propriedades do parâmetro
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
-Name
Especifica um nome de contêiner de armazenamento do Azure.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: N, Contêiner
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
-Permission
Especifica permissões para um contêiner de armazenamento.
É importante observar que essa é uma cadeia de caracteres, como rwd (para Leitura, Gravação e Exclusão). As permissões com suporte para o tipo de recurso de contêiner são descritas aqui .
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 uma Política de Acesso Armazenado do Azure.
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: Nullable<T> [ Microsoft.Azure.Storage.SharedAccessProtocol ]
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
-StartTime
Especifica a hora em que a assinatura de acesso compartilhado se torna válida.
Propriedades do parâmetro
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
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: wi
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 .
Saídas