Compartir a través de

New-AzStorageContainerSASToken

  • Referencia
Módulo:
Az.Storage

Genera un token de SAS para un contenedor de Azure Storage.

Sintaxis

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

El cmdlet New-AzStorageContainerSASToken genera un token de firma de acceso compartido (SAS) para un contenedor de almacenamiento de Azure.

Ejemplos

Ejemplo 1: Generación de un token de SAS de contenedor con permiso de contenedor completo

New-AzStorageContainerSASToken -Name "Test" -Permission rwdl

En este ejemplo se genera un token saS de contenedor con permiso de contenedor completo.

Ejemplo 2: Generación de varios tokens saS de contenedor por canalización

Get-AzStorageContainer -Container test* | New-AzStorageContainerSASToken -Permission rwdl

En este ejemplo se generan varios tokens saS de contenedor mediante la canalización.

Ejemplo 3: Generación de un token de SAS de contenedor con directiva de acceso compartido

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

En este ejemplo se genera un token saS de contenedor con directiva de acceso compartido.

Ejemplo 3: Generación de un token saS de contenedor de identidad de usuario con contexto de almacenamiento basado en la autenticación de 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

En este ejemplo se genera un token saS de contenedor de identidad de usuario con contexto de almacenamiento basado en la autenticación de OAuth.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Context

Especifica un contexto de almacenamiento de Azure. Puede crearlo mediante el cmdlet New-AzStorageContext. Cuando el contexto de almacenamiento se basa en la autenticación de OAuth, generará un token saS de contenedor de identidad de usuario.

Tipo:IStorageContext
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EncryptionScope

Ámbito de cifrado que se usará al enviar solicitudes autorizadas con este URI de SAS.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExpiryTime

Especifica la hora en la que la firma de acceso compartido deja de ser válida. Si el usuario establece la hora de inicio, pero no la hora de expiración, la hora de expiración se establece en la hora de inicio más una hora. Si no se especifica la hora de inicio ni la hora de expiración, la hora de expiración se establece en la hora actual más una hora. Cuando el contexto de almacenamiento se basa en la autenticación de OAuth, la hora de expiración debe estar en 7 días a partir de la hora actual y no debe ser anterior a la hora actual.

Tipo:Nullable<T>[DateTime]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FullUri

Indica que este cmdlet devuelve el URI de blob completo y el token de firma de acceso compartido.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IPAddressOrRange

Especifica la dirección IP o el intervalo de direcciones IP desde las que aceptar solicitudes, como 168.1.5.65 o 168.1.5.60-168.1.5.70. El intervalo es inclusivo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica un nombre de contenedor de Azure Storage.

Tipo:String
Alias:N, Container
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Permission

Especifica permisos para un contenedor de almacenamiento. Es importante tener en cuenta que se trata de una cadena, como rwd (para Lectura, Escritura y Eliminación). Los permisos que se admiten para el tipo de recurso de contenedor se describen aquí.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Policy

Especifica una directiva de acceso almacenada de Azure.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Protocol

Especifica el protocolo permitido para una solicitud. Los valores permitidos para este parámetro son los siguientes:

  • HttpsOnly
  • HttpsOrHttp El valor predeterminado es HttpsOrHttp.
Tipo:Nullable<T>[SharedAccessProtocol]
Valores aceptados:HttpsOnly, HttpsOrHttp
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-StartTime

Especifica la hora en la que la firma de acceso compartido es válida.

Tipo:Nullable<T>[DateTime]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

IStorageContext

Salidas

String