Partager via

New-AzureStorageContext

  • Référence
Module:
Azure.Storage

Crée un contexte de stockage Azure.

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-AzureStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   -ConnectionString <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-Local]
   [<CommonParameters>]

Description

L’applet de commande New-AzureStorageContext crée un contexte Stockage Azure.

Exemples

Exemple 1 : Créer un contexte en spécifiant un nom et une clé de compte de stockage

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"

Cette commande crée un contexte pour le compte nommé ContosoGeneral qui utilise la clé spécifiée.

Exemple 2 : Créer un contexte en spécifiant un chaîne de connexion

C:\PS>New-AzureStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

Cette commande crée un contexte basé sur le chaîne de connexion spécifié pour le compte ContosoGeneral.

Exemple 3 : Créer un contexte pour un compte de stockage anonyme

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"

Cette commande crée un contexte d’utilisation anonyme pour le compte nommé ContosoGeneral. La commande spécifie HTTP comme protocole de connexion.

Exemple 4 : Créer un contexte à l’aide du compte de stockage de développement local

C:\PS>New-AzureStorageContext -Local

Cette commande crée un contexte à l’aide du compte de stockage de développement local. La commande spécifie le paramètre local .

Exemple 5 : Obtenir le conteneur pour le compte de stockage du développeur local

C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainer

Cette commande crée un contexte à l’aide du compte de stockage de développement local, puis transmet le nouveau contexte à l’applet de commande Get-AzureStorageContainer à l’aide de l’opérateur de pipeline. La commande obtient le conteneur Stockage Azure pour le compte de stockage du développeur local.

Exemple 6 : Obtenir plusieurs conteneurs

C:\PS>$Context01 = New-AzureStorageContext -Local 
PS C:\> $Context02 = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($Context01, $Context02) | Get-AzureStorageContainer

La première commande crée un contexte à l’aide du compte de stockage de développement local, puis stocke ce contexte dans la variable $Context 01. La deuxième commande crée un contexte pour le compte nommé ContosoGeneral qui utilise la clé spécifiée, puis stocke ce contexte dans la variable $Context 02. La commande finale obtient les conteneurs pour les contextes stockés dans $Context 01 et $Context 02 à l’aide de Get-AzureStorageContainer.

Exemple 7 : Créer un contexte avec un point de terminaison

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"

Cette commande crée un contexte Stockage Azure qui a le point de terminaison de stockage spécifié. La commande crée le contexte du compte nommé ContosoGeneral qui utilise la clé spécifiée.

Exemple 8 : Créer un contexte avec un environnement spécifié

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"

Cette commande crée un contexte de stockage Azure qui a l’environnement Azure spécifié. La commande crée le contexte du compte nommé ContosoGeneral qui utilise la clé spécifiée.

Exemple 9 : Créer un contexte à l’aide d’un jeton SAP

C:\PS>$SasToken = New-AzureStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
PS C:\> $Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $Context | Get-AzureStorageBlob -Container "ContosoMain"

La première commande génère un jeton SAP à l’aide de l’applet de commande New-AzureStorageContainerSASToken pour le conteneur nommé ContosoMain, puis stocke ce jeton dans la variable $SasToken. Ce jeton est destiné aux autorisations de lecture, d’ajout, de mise à jour et de suppression. La deuxième commande crée un contexte pour le compte nommé ContosoGeneral qui utilise le jeton SAP stocké dans $SasToken, puis stocke ce contexte dans la variable $Context. La commande finale répertorie tous les objets blob associés au conteneur nommé ContosoMain à l’aide du contexte stocké dans $Context.

Exemple 10 : Créer un contexte à l’aide de l’authentification OAuth

C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Cette commande crée un contexte à l’aide de l’authentification OAuth.

Paramètres

-Anonymous

Indique que cette applet de commande crée un contexte Stockage Azure pour l’ouverture de session anonyme.

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

-ConnectionString

Spécifie un chaîne de connexion pour le contexte de Stockage 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

-Endpoint

Spécifie le point de terminaison du contexte Stockage Azure.

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

-Environment

Spécifie l’environnement Azure. Les valeurs acceptables pour ce paramètre sont : AzureCloud et AzureChinaCloud. Pour plus d'informations, voir Get-Help Get-AzureEnvironment.

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

-Local

Indique que cette applet de commande crée un contexte à l’aide du compte de stockage de développement local.

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

Protocole de transfert (https/http).

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

-SasToken

Spécifie un jeton SAS (Shared Access Signature) pour le contexte.

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

-StorageAccountKey

Spécifie une clé de compte Stockage Azure. Cette applet de commande crée un contexte pour la clé spécifiée par ce paramètre.

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

-StorageAccountName

Spécifie un nom de compte Stockage Azure. Cette applet de commande crée un contexte pour le compte spécifié par ce paramètre.

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

-UseConnectedAccount

Indique que cette applet de commande crée un contexte Stockage Azure avec l’authentification OAuth. L’applet de commande utilise l’authentification OAuth par défaut, lorsque d’autres authentifications ne sont pas spécifiées.

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

Entrées

String

Sorties

AzureStorageContext