Partager via


New-AzStorageContext

Crée un contexte de stockage Azure.

Syntaxe

OAuthAccount (Par défaut)

New-AzStorageContext
    [-StorageAccountName] <String>
    [-UseConnectedAccount]
    [-Protocol <String>]
    [-Endpoint <String>]
    [-EnableFileBackupRequestIntent]
    [<CommonParameters>]

AccountNameAndKey

New-AzStorageContext
    [-StorageAccountName] <String>
    [-StorageAccountKey] <String>
    [-Protocol <String>]
    [-Endpoint <String>]
    [<CommonParameters>]

AccountNameAndKeyEnvironment

New-AzStorageContext
    [-StorageAccountName] <String>
    [-StorageAccountKey] <String>
    -Environment <String>
    [-Protocol <String>]
    [<CommonParameters>]

AnonymousAccount

New-AzStorageContext
    [-StorageAccountName] <String>
    [-Anonymous]
    [-Protocol <String>]
    [-Endpoint <String>]
    [<CommonParameters>]

AnonymousAccountEnvironment

New-AzStorageContext
    [-StorageAccountName] <String>
    -Environment <String>
    [-Anonymous]
    [-Protocol <String>]
    [<CommonParameters>]

SasToken

New-AzStorageContext
    [-StorageAccountName] <String>
    -SasToken <String>
    [-Protocol <String>]
    [-Endpoint <String>]
    [<CommonParameters>]

SasTokenWithAzureEnvironment

New-AzStorageContext
    [-StorageAccountName] <String>
    -SasToken <String>
    -Environment <String>
    [<CommonParameters>]

OAuthAccountEnvironment

New-AzStorageContext
    [-StorageAccountName] <String>
    -Environment <String>
    [-UseConnectedAccount]
    [-Protocol <String>]
    [-EnableFileBackupRequestIntent]
    [<CommonParameters>]

AccountNameAndKeyServiceEndpoint

New-AzStorageContext
    [-StorageAccountName] <String>
    [-StorageAccountKey] <String>
    -BlobEndpoint <String>
    [-FileEndpoint <String>]
    [-QueueEndpoint <String>]
    [-TableEndpoint <String>]
    [<CommonParameters>]

OAuthAccountServiceEndpoint

New-AzStorageContext
    [[-StorageAccountName] <String>]
    [-UseConnectedAccount]
    [-BlobEndpoint <String>]
    [-FileEndpoint <String>]
    [-QueueEndpoint <String>]
    [-TableEndpoint <String>]
    [-EnableFileBackupRequestIntent]
    [<CommonParameters>]

SasTokenServiceEndpoint

New-AzStorageContext
    -SasToken <String>
    [-BlobEndpoint <String>]
    [-FileEndpoint <String>]
    [-QueueEndpoint <String>]
    [-TableEndpoint <String>]
    [<CommonParameters>]

ConnectionString

New-AzStorageContext
    -ConnectionString <String>
    [<CommonParameters>]

LocalDevelopment

New-AzStorageContext
    [-Local]
    [<CommonParameters>]

AnonymousAccountServiceEndpoint

New-AzStorageContext
    [-Anonymous]
    [-BlobEndpoint <String>]
    [-FileEndpoint <String>]
    [-QueueEndpoint <String>]
    [-TableEndpoint <String>]
    [<CommonParameters>]

Description

L’applet de commande New-AzStorageContext crée un contexte de 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 une 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 la chaîne de connexion spécifiée 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 de 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 le point de terminaison 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-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 de stockage Azure pour l’ouverture de session anonyme.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AnonymousAccount
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccountEnvironment
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccountServiceEndpoint
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-BlobEndpoint

Point de terminaison du service d’objets blob stockage Azure

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AccountNameAndKeyServiceEndpoint
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ConnectionString

Spécifie une chaîne de connexion pour le contexte stockage Azure.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ConnectionString
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

OAuthAccount
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
OAuthAccountEnvironment
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
OAuthAccountServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Endpoint

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

OAuthAccount
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AccountNameAndKey
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccount
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SasToken
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Environment

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Nom, EnvironmentName

Jeux de paramètres

AccountNameAndKeyEnvironment
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
AnonymousAccountEnvironment
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-FileEndpoint

Point de terminaison du service de fichiers stockage Azure

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AccountNameAndKeyServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
OAuthAccountServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SasTokenServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccountServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Local

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

LocalDevelopment
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Protocol

Protocole de transfert (https/http).

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Http, Https
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

OAuthAccount
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AccountNameAndKey
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AccountNameAndKeyEnvironment
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccount
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccountEnvironment
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SasToken
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
OAuthAccountEnvironment
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-QueueEndpoint

Point de terminaison du service de file d’attente stockage Azure

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AccountNameAndKeyServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
OAuthAccountServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SasTokenServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccountServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SasToken

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SasToken
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SasTokenWithAzureEnvironment
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SasTokenServiceEndpoint
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageAccountKey

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AccountNameAndKey
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AccountNameAndKeyEnvironment
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AccountNameAndKeyServiceEndpoint
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageAccountName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

OAuthAccount
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AccountNameAndKey
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AccountNameAndKeyEnvironment
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccount
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccountEnvironment
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SasToken
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SasTokenWithAzureEnvironment
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
OAuthAccountEnvironment
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AccountNameAndKeyServiceEndpoint
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-TableEndpoint

Point de terminaison du service de table stockage Azure

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AccountNameAndKeyServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
OAuthAccountServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SasTokenServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
AnonymousAccountServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UseConnectedAccount

Indique que cette applet de commande crée un contexte de 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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

OAuthAccount
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
OAuthAccountEnvironment
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
OAuthAccountServiceEndpoint
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Sorties

AzureStorageContext