Partager via


New-AzureStorageShareSASToken

Générer un jeton de signature d’accès partagé pour Stockage Azure partage.

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-AzureStorageShareSASToken
   [-ShareName] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageShareSASToken
   [-ShareName] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

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

Exemples

Exemple 1 : Générer un jeton de signature d’accès partagé pour un partage

PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"

Cette commande crée un jeton de signature d’accès partagé pour le partage nommé ContosoShare.

Exemple 2 : Générer plusieurs jetons de signature d’accès partagé à l’aide du pipeline

PS C:\>Get-AzureStorageShare -Prefix "test" | New-AzureStorageShareSASToken -Permission "rwdl"

Cette commande obtient tous les partages de stockage qui correspondent au test de préfixe. La commande les transmet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle crée un jeton d’accès partagé pour chaque partage de stockage disposant des autorisations spécifiées.

Exemple 3 : Générer un jeton de signature d’accès partagé qui utilise une stratégie d’accès partagé

PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"

Cette commande crée un jeton de signature d’accès partagé pour le partage de stockage nommé ContosoShare qui a la stratégie nommée ContosoPolicy03.

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

-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

-Permission

Spécifie les autorisations dans le jeton pour accéder au partage et aux fichiers sous le partage. 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 partage.

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
Alias:N, Name
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

IStorageContext

Sorties

String

Notes

  • Mots clés : common, azure, services, data, storage, blob, queue, table