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.

Sintaxis

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.

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

-ExpiryTime

Especifica la hora en la que la firma de acceso compartido deja de ser 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

-File

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

Tipo:CloudFile
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

-Path

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

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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).

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

-Policy

Especifica la directiva de acceso almacenada para un archivo.

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

-ShareName

Especifica el nombre del recurso compartido de almacenamiento.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

Entradas

String

CloudFile

IStorageContext

Parámetros: Contexto (ByValue)

Salidas

String