New-AzStorageContainerSASToken

  • Referencia
Módulo:
Az.Storage

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

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionScope

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullUri

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica un nombre de contenedor de Azure Storage.

Type:String
Aliases:N, Container
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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í.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Policy

Especifica una directiva de acceso almacenada de Azure.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.
Type:Nullable<T>[SharedAccessProtocol]
Accepted values:HttpsOnly, HttpsOrHttp
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartTime

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

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

IStorageContext

Salidas

String