Leer en inglés

Compartir a través de

New-AzStorageFileSASToken

  • Referencia
Módulo:
Az.Storage

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

Sintaxis

PowerShell 
New-AzStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   [-Permission <String>]
   [-Protocol <String>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
PowerShell 
New-AzStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   -Policy <String>
   [-Protocol <String>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
PowerShell 
New-AzStorageFileSASToken
   -ShareFileClient <ShareFileClient>
   [-Permission <String>]
   [-Protocol <String>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
PowerShell 
New-AzStorageFileSASToken
   -ShareFileClient <ShareFileClient>
   -Policy <String>
   [-Protocol <String>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet New-AzStorageFileSASToken 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

PowerShell 
New-AzStorageFileSASToken -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

PowerShell 
$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -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-AzStorageContext.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan 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

-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 aceptables para este parámetro son:

  • HttpsOnly
  • HttpsOrHttp El valor predeterminado es HttpsOrHttp.
Tipo:String
Valores aceptados:HttpsOnly, HttpsOrHttp
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ShareFileClient

Instancia de ShareFileClient en la que se va a representar el archivo para obtener el token de SAS.

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

Salidas