Partager via


New-AzStorageContext

Crée un contexte de stockage Azure.

Syntaxe

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   -Environment <String>
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   -BlobEndpoint <String>
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   -SasToken <String>
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   -ConnectionString <String>
   [<CommonParameters>]
New-AzStorageContext
   [-Local]
   [<CommonParameters>]
New-AzStorageContext
   [-Anonymous]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-UseConnectedAccount]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

Description

L’applet de commande New-AzStorageContext crée un contexte Stockage Azure. L’authentification par défaut d’un contexte de stockage est OAuth (ID Microsoft Entra), si seul le nom du compte de stockage d’entrée est entré. Consultez les détails de l’authentification du service de stockage dans https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

Exemples

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

New-AzStorageContext -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

New-AzStorageContext -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

New-AzStorageContext -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

New-AzStorageContext -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

New-AzStorageContext -Local | Get-AzStorageContainer

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-AzStorageContainer à 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

$Context01 = New-AzStorageContext -Local 
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer

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-AzStorageContainer.

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

New-AzStorageContext -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é

New-AzStorageContext -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

$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"

La première commande génère un jeton SAP à l’aide de l’applet de commande New-AzStorageContainerSASToken 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

Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Cette commande crée un contexte à l’aide de l’authentification OAuth (Microsoft Entra ID).

Exemple 11 : Créer un contexte en spécifiant un nom de compte de stockage, une clé de compte de stockage et un point de terminaison d’objet blob personnalisé

New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Cette commande crée un contexte pour le compte nommé myaccountname avec une clé pour le compte et le point de terminaison d’objet blob spécifié.

Exemple 12 : Créer un contexte pour un compte de stockage anonyme avec le point de terminaison d’objet blob spécifié

New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Cette commande crée un contexte d’utilisation anonyme pour le compte nommé myaccountname, avec un point d’objet blob spécifié.

Exemple 13 : Créer un contexte à l’aide d’un jeton SAP avec des points de terminaison spécifiés

$SasToken = New-AzStorageContainerSASToken -Name "MyContainer" -Permission "rad"
New-AzStorageContext -SasToken $SasToken -BlobEndpoint "https://myaccountname.blob.core.windows.net/" -TableEndpoint "https://myaccountname.table.core.windows.net/" -FileEndpoint "https://myaccountname.file.core.windows.net/" -QueueEndpoint "https://myaccountname.queue.core.windows.net/"

La première commande génère un jeton SAS à l’aide de l’applet de commande New-AzStorageContainerSASToken pour le conteneur nommé MyContainer, puis stocke ce jeton dans la variable $SasToken. La deuxième commande crée un contexte qui utilise le jeton SAP et un point de terminaison d’objet blob, un point de terminaison de table, un point de terminaison de fichier et un point de terminaison de file d’attente spécifiés.

Exemple 14 : Créer un contexte à l’aide de l’authentification OAuth avec un point de terminaison d’objet blob spécifié

New-AzStorageContext -UseConnectedAccount -BlobEndpoint  "https://myaccountname.blob.core.windows.net/"

Cette commande crée un contexte à l’aide de l’authentification OAuth avec un point de terminaison d’objet blob spécifié.

Exemple 15 : Créer un contexte à l’aide de l’authentification OAuth sur le service de fichiers

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent

Cette commande crée un contexte pour utiliser l’authentification OAuth (Microsoft Entra ID) sur le service de fichiers. Le paramètre « -EnableFileBackupRequestIntent » est requis pour utiliser l’authentification OAuth (Microsoft Entra ID) pour le service de fichiers. Cela contournera les vérifications d’autorisation au niveau du fichier/répertoire et autorisera l’accès, en fonction des actions de données autorisées, même s’il existe des listes de contrôle d’accès en place pour ces fichiers/répertoires.

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

-BlobEndpoint

Point de terminaison du service d’objets blob 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

-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

-EnableFileBackupRequestIntent

Paramètre obligatoire à utiliser avec l’authentification OAuth (Microsoft Entra ID) pour les fichiers. Cela contournera les vérifications d’autorisation au niveau du fichier/répertoire et autorisera l’accès, en fonction des actions de données autorisées, même s’il existe des listes de contrôle d’accès en place pour ces fichiers/répertoires.

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

-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-AzEnvironment.

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

-FileEndpoint

Point de terminaison du service de fichiers 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

-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

-QueueEndpoint

Point de terminaison du service de file d’attente 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

-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

-TableEndpoint

Point de terminaison du service de table 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

-UseConnectedAccount

Indique que cette applet de commande crée un contexte Stockage Azure avec l’authentification OAuth (Microsoft Entra ID). 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