New-AzStorageFileSASToken
Genera un token de firma de acceso compartido para un archivo de almacenamiento.
Sintaxis
NameSasPermission
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
NameSasPolicy
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
-Policy <String>
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
FileSasPermission
New-AzStorageFileSASToken
-ShareFileClient <ShareFileClient>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
FileSasPolicy
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
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
$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.
Propiedades de parámetro
Tipo: IStorageContext
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: True Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
Propiedades de parámetro
Tipo: IAzureContextContainer
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: AzureRmContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ExpiryTime
Especifica la hora en la que la firma de acceso compartido deja de ser válida.
Propiedades de parámetro
Tipo: Nullable<T> [ DateTime ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-FullUri
Indica que este cmdlet devuelve el URI de blob completo y el token de firma de acceso compartido.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Path
Especifica la ruta de acceso del archivo en relación con un recurso compartido de almacenamiento.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
NameSasPermission
Posición: 1 Obligatorio: True Valor de la canalización: True Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
NameSasPolicy
Posición: 1 Obligatorio: True Valor de la canalización: True Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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).
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
NameSasPermission
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
FileSasPermission
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Policy
Especifica la directiva de acceso almacenada para un archivo.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
NameSasPolicy
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
FileSasPolicy
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Protocol
Especifica el protocolo permitido para una solicitud.
Los valores aceptables para este parámetro son:
HttpsOnly
HttpsOrHttp El valor predeterminado es HttpsOrHttp.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Valores aceptados: HttpsOnly, HttpsOrHttp Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ShareFileClient
Instancia de ShareFileClient en la que se va a representar el archivo para obtener el token de SAS.
Propiedades de parámetro
Tipo: ShareFileClient
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
FileSasPermission
Posición: Named Obligatorio: True Valor de la canalización: True Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
FileSasPolicy
Posición: Named Obligatorio: True Valor de la canalización: True Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-ShareName
Especifica el nombre del recurso compartido de almacenamiento.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
NameSasPermission
Posición: 0 Obligatorio: True Valor de la canalización: True Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
NameSasPolicy
Posición: 0 Obligatorio: True Valor de la canalización: True Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-StartTime
Especifica la hora en la que la firma de acceso compartido es válida.
Propiedades de parámetro
Tipo: Nullable<T> [ DateTime ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas