Partager via

New-AzStorageBlobSASToken

  • Référence
Module:
Az.Storage

Génère un jeton SAP pour un objet blob de stockage Azure.

Syntaxe

New-AzStorageBlobSASToken
   [-Container] <String>
   [-Blob] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStorageBlobSASToken
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStorageBlobSASToken
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStorageBlobSASToken
   [-Container] <String>
   [-Blob] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzStorageBlobSASToken génère un jeton SAS (Shared Access Signature) pour un objet blob de stockage Azure.

Exemples

Exemple 1 : Générer un jeton SAP d’objet blob avec autorisation d’objet blob complète

New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd

Cet exemple génère un jeton SAS d’objet blob avec une autorisation d’objet blob complète.

Exemple 2 : Générer un jeton SAS d’objet blob avec durée de vie

$StartTime = Get-Date
$EndTime = $startTime.AddHours(2.0)
New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime

Cet exemple génère un jeton SAS d’objet blob avec durée de vie.

Exemple 3 : Générer un jeton SAP d’identité utilisateur avec un contexte de stockage basé sur l’authentification OAuth

$ctx = New-AzStorageContext -StorageAccountName $accountName -UseConnectedAccount
$StartTime = Get-Date
$EndTime = $startTime.AddDays(6)
New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime -Context $ctx

Cet exemple génère un jeton SAS d’objet blob d’identité utilisateur avec un contexte de stockage basé sur l’authentification OAuth

Paramètres

-Blob

Spécifie le nom de l’objet blob de stockage.

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

-BlobBaseClient

Objet BlobBaseClient

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

-CloudBlob

Spécifie l’objet CloudBlob . Pour obtenir un objet CloudBlob , utilisez l’applet de commande Get-AzStorageBlob .

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Container

Spécifie le nom du conteneur de stockage.

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

-Context

Spécifie le contexte de stockage. Lorsque le contexte de stockage est basé sur l’authentification OAuth, génère un jeton SAP d’objet blob d’identité utilisateur.

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

-EncryptionScope

Étendue de chiffrement à utiliser lors de l’envoi de requêtes autorisées avec cet URI SAP.

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

-ExpiryTime

Spécifie quand la signature d’accès partagé expire. Lorsque le contexte de stockage est basé sur l’authentification OAuth, l’heure d’expiration doit être comprise entre 7 jours et l’heure actuelle et ne doit pas être antérieure à l’heure actuelle.

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 d’un objet blob 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 une stratégie d’accès stockée Azure.

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

-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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
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

CloudBlob

IStorageContext

Sorties

String