Partager via

New-AzureStorageFileSASToken

  • Référence
Module:
Azure.Storage

Génère un jeton de signature d’accès partagé pour un fichier de stockage.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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

L’applet de commande New-AzureStorageFileSASToken génère un jeton de signature d’accès partagé pour un fichier Stockage Azure.

Exemples

Exemple 1 : Générer un jeton de signature d’accès partagé disposant d’autorisations de fichier complètes

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

Cette commande génère un jeton de signature d’accès partagé qui dispose d’autorisations complètes pour le fichier nommé FilePath.

Exemple 2 : Générer un jeton de signature d’accès partagé qui a une limite de temps

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

La première commande crée un objet DateTime à l’aide de l’applet de commande Get-Date. La commande stocke l’heure actuelle dans la variable $StartTime. La deuxième commande ajoute deux heures à l’objet dans $StartTime, puis stocke le résultat dans la variable $EndTime. Cet objet est une heure de deux heures à l’avenir. La troisième commande génère un jeton de signature d’accès partagé disposant des autorisations spécifiées. Ce jeton devient valide à l’heure actuelle. Le jeton reste valide jusqu’à ce que le temps soit stocké dans $EndTime.

Paramètres

-Context

Spécifie un contexte Stockage Azure. Pour obtenir un contexte, utilisez l’applet de commande New-AzureStorageContext.

Type:IStorageContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExpiryTime

Spécifie l’heure à laquelle la signature d’accès partagé devient non valide.

Type:Nullable<T>[DateTime]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-File

Spécifie un objet CloudFile . Vous pouvez créer un fichier cloud ou en obtenir un à l’aide de l’applet de commande Get-AzureStorageFile.

Type:CloudFile
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-FullUri

Indique que cette applet de commande retourne l’URI d’objet blob complet et le jeton de signature d’accès partagé.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IPAddressOrRange

Spécifie l’adresse IP ou la plage d’adresses IP à partir de laquelle accepter des demandes, telles que 168.1.5.65 ou 168.1.5.60-168.1.5.70. La plage est inclusive.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès du fichier par rapport à un partage de stockage.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Permission

Spécifie les autorisations d’un fichier de stockage. Il est important de noter qu’il s’agit d’une chaîne, comme rwd (pour lecture, écriture et suppression).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Policy

Spécifie la stratégie d’accès stockée pour un fichier.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Protocol

Spécifie le protocole autorisé pour une demande. Les valeurs valides pour ce paramètre sont :

  • HttpsOnly
  • HttpsOrHttp La valeur par défaut est HttpsOrHttp.
Type:Nullable<T>[SharedAccessProtocol]
Valeurs acceptées:HttpsOnly, HttpsOrHttp
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ShareName

Spécifie le nom du partage de stockage.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-StartTime

Spécifie l’heure à laquelle la signature d’accès partagé devient valide.

Type:Nullable<T>[DateTime]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

CloudFile

IStorageContext

Paramètres : Context (ByValue)

Sorties

String