New-AzStorageContext
Crée un contexte de stockage Azure.
Syntax
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-Az Stockage Context crée un contexte Stockage Azure. L’authentification par défaut d’un contexte de Stockage est OAuth (ID Microsoft Entra), si seule l’entrée Stockage nom du compte. Consultez les détails de l’authentification du service 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 -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
New-AzStorageContext -Local | Get-AzStorageContainerCette 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-Az 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
$Context01 = New-AzStorageContext -Local
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainerLa 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-Az Stockage Container.
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-Az 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
Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountCette 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 SAP à l’aide de l’applet de commande New-Az Stockage ContainerSASToken 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 -EnableFileBackupRequestIntentCette 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 toute autorisation de niveau fichier/répertoire case activée s 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Point de terminaison du service d’objets blob stockage Azure
| Type: | String |
| 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 |
-EnableFileBackupRequestIntent
Paramètre obligatoire à utiliser avec l’authentification OAuth (Microsoft Entra ID) pour les fichiers. Cela contournera toute autorisation de niveau fichier/répertoire case activée s 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 |
| Default value: | None |
| Required: | False |
| 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-AzEnvironment.
| Type: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileEndpoint
Point de terminaison du service de fichiers stockage Azure
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-QueueEndpoint
Point de terminaison du service de file d’attente stockage Azure
| Type: | String |
| 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 |
-TableEndpoint
Point de terminaison du service de table stockage Azure
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 (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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entrées
Sorties
Liens associés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour