New-AzureStorageContext
Crée un contexte de stockage Azure.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis 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.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntax
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-Azure Stockage Context 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 -LocalCette 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-AzureStorageContainerCette 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-Azure Stockage Container à 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-AzureStorageContainerLa 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-Azure Stockage Container.
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-Azure Stockage ContainerSASToken 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" -UseConnectedAccountCette 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionString
Spécifie un chaîne de connexion pour le contexte de Stockage Azure.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Endpoint
Spécifie le point de terminaison du contexte Stockage Azure.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Protocole de transfert (https/http).
| Type: | String |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SasToken
Spécifie un jeton SAS (Shared Access Signature) pour le contexte.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |