Partager via

Set-AzureSubscription

  • Référence
Module:
Azure

Modifie un abonnement Azure.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Set-AzureSubscription
   -SubscriptionId <String>
   [-Certificate <X509Certificate2>]
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureSubscription
   -SubscriptionName <String>
   [-Certificate <X509Certificate2>]
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureSubscription
   -SubscriptionName <String>
   -SubscriptionId <String>
   -Certificate <X509Certificate2>
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureSubscription établit et modifie les propriétés d’un objet d’abonnement Azure. Vous pouvez utiliser cette applet de commande pour travailler dans un abonnement Azure qui n’est pas votre abonnement par défaut ou pour modifier votre compte de stockage actuel. Pour plus d’informations sur les abonnements actuels et par défaut, consultez l’applet de commande Select-AzureSubscription .

Cette applet de commande fonctionne sur un objet d’abonnement Azure, et non sur votre abonnement Azure réel. Pour créer et approvisionner un abonnement Azure, visitez le portail Azure (https://azure.microsoft.com/).

Cette applet de commande modifie les données du fichier de données d’abonnement que vous créez lorsque vous utilisez l’applet de commande Add-AzureAccount ou Import-AzurePublishSettingsFile pour ajouter un compte Azure à Windows PowerShell.

Cette rubrique décrit l’applet de commande dans la version 0.8.10 du module Microsoft Azure PowerShell. Pour obtenir la version du module que vous utilisez, dans la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

Exemples

Exemple 1 : Modifier un abonnement existant1

C:\PS> $thumbprint = <Thumbprint-2>
C:\PS> $differentCert = Get-Item cert:\\CurrentUser\My\$thumbprint
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $differentCert

Cet exemple montre comment modifier le certificat de l’abonnement nommé ContosoEngineering.

Exemple 2 : Modifier le point de terminaison de service

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -ServiceEndpoint "https://management.core.contoso.com"

Cette commande ajoute ou modifie un point de terminaison de service personnalisé pour l’abonnement ContosoEngineering.

Exemple 3 : Effacer les valeurs de propriété

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $null -ResourceManagerEndpoint $Null

Cette commande définit les valeurs des propriétés Certificate et ResourceManagerEndpoint sur Null ($Null). Cela efface les valeurs de ces propriétés sans modifier d’autres paramètres.

Exemple 4 : Utiliser un autre fichier de données d’abonnement

C:\PS> Set-AzureSubscription -SubscriptionName ContosoFinance -SubscriptionDataFile C:\Azure\SubscriptionData.xml -CurrentStorageAccount ContosoStorage01

Cette commande modifie le compte de stockage actuel de l’abonnement ContosoFinance à ContosoStorage01. La commande utilise le paramètre SubscriptionDataFile pour modifier les données dans le fichier de données d’abonnement C :\Azure\SubscriptionData.xml. Par défaut, Set-AzureSubscription utilise le fichier de données d’abonnement par défaut dans votre profil utilisateur itinérant.

Paramètres

-Certificate

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

-Context

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

-CurrentStorageAccountName

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 un environnement Azure.

Un environnement Azure un déploiement indépendant de Microsoft Azure, tel qu’AzureCloud pour Azure global et AzureChinaCloud pour Azure géré par 21Vianet en Chine. Vous pouvez également créer des environnements Azure locaux à l’aide d’Azure Pack et des applets de commande WAPack. Pour plus d’informations, consultez Azure Pack.

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

-PassThru

Retourne $True si la commande réussit et $False en cas d’échec. Par défaut, cette applet de commande ne retourne aucune sortie.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-ResourceManagerEndpoint

Spécifie le point de terminaison pour les données Azure Resource Manager, y compris les données relatives aux groupes de ressources associés au compte. Pour plus d’informations sur Azure Resource Manager, consultez applets de commande Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) et utilisation de Windows PowerShell avec Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).

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

-ServiceEndpoint

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

-SubscriptionId

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

-SubscriptionName

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

Entrées

None

Vous pouvez diriger l’entrée vers cette applet de commande par nom de propriété, mais pas par valeur.

Sorties

None or System.Boolean

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne une valeur booléenne. Par défaut, cette applet de commande ne retourne aucune sortie.