Compartir a través de

New-AzureStorageFileSASToken

  • Referencia
Módulo:
Azure.Storage

Genera un token de firma de acceso compartido para un archivo de almacenamiento.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

New-AzureStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageFileSASToken
   -File <CloudFile>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageFileSASToken
   -File <CloudFile>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet New-AzureStorageFileSASToken genera un token de firma de acceso compartido para un archivo de Azure Storage.

Ejemplos

Ejemplo 1: Generación de un token de firma de acceso compartido que tenga permisos de archivo completos

PS C:\> New-AzureStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"

Este comando genera un token de firma de acceso compartido que tiene permisos completos para el archivo denominado FilePath.

Ejemplo 2: Generación de un token de firma de acceso compartido que tiene un límite de tiempo

PS C:\> $StartTime = Get-Date
PS C:\> $EndTime = $StartTime.AddHours(2.0)
PS C:\> New-AzureStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime

El primer comando crea un objeto DateTime mediante el cmdlet Get-Date. El comando almacena la hora actual en la variable $StartTime. El segundo comando agrega dos horas al objeto en $StartTime y, a continuación, almacena el resultado en la variable $EndTime. Este objeto es una hora de dos horas en el futuro. El tercer comando genera un token de firma de acceso compartido que tiene los permisos especificados. Este token se convierte en válido en la hora actual. El token permanece válido hasta que el tiempo se almacena en $EndTime.

Parámetros

-Context

Especifica un contexto de Azure Storage. Para obtener un contexto, use el cmdlet New-AzureStorageContext.

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

-ExpiryTime

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

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

-File

Especifica un objeto CloudFile . Puede crear un archivo en la nube o obtener uno mediante el cmdlet Get-AzureStorageFile.

Type:CloudFile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-Path

Especifica la ruta de acceso del archivo en relación con un recurso compartido de almacenamiento.

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

-Permission

Especifica los permisos de un archivo de almacenamiento. Es importante tener en cuenta que se trata de una cadena, como rwd (para Lectura, Escritura y Eliminación).

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

-Policy

Especifica la directiva de acceso almacenada para un archivo.

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

-ShareName

Especifica el nombre del recurso compartido de almacenamiento.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

Entradas

String

CloudFile

IStorageContext

Parámetros: Contexto (ByValue)

Salidas

String