Select-AzureSubscription

  • Référence
Module:
Azure

Modifie les abonnements Azure actuels et par défaut.

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

Select-AzureSubscription
      -SubscriptionName <String>
      [-Account <String>]
      [-Current]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionName <String>
      [-Account <String>]
      [-Default]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionId <String>
      [-Account <String>]
      [-Current]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionId <String>
      [-Account <String>]
      [-Default]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      [-Account <String>]
      [-NoCurrent]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      [-Account <String>]
      [-NoDefault]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

L’applet de commande Select-AzureSubscription définit et efface les abonnements Azure actuels et par défaut.

L'« abonnement actuel » est l’abonnement utilisé par défaut dans la session Windows PowerShell actuelle. L'« abonnement par défaut » est utilisé par défaut dans toutes les sessions Windows PowerShell. L’étiquette « abonnement actuel » vous permet de spécifier un autre abonnement à utiliser par défaut pour la session active sans modifier l'« abonnement par défaut » pour toutes les autres sessions.

La désignation d’abonnement « par défaut » est enregistrée dans votre fichier de données d’abonnement. La désignation « actuelle » spécifique à la session n’est pas enregistrée.

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 : Définir l’abonnement actuel

C:\PS> Select-AzureSubscription -Current -SubscriptionName ContosoEngineering

Cette commande rend « ContosoEngineering » l’abonnement actuel.

Exemple 2 : Définir l’abonnement par défaut

C:\PS> Select-AzureSubscription -Default -SubscriptionName ContosoFinance -SubscriptionDataFile "C:\subs\MySubscriptions.xml"

Cette commande remplace l’abonnement par défaut par « ContosoFinance ». Il enregistre le paramètre dans le fichier de données d’abonnement Subscriptions.xml, au lieu du fichier de données d’abonnement par défaut.

Paramètres

-Account

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

-Current

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

-Default

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

-NoCurrent

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

-NoDefault

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

-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

-SubscriptionId

Type:String
Alias:Id
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
Alias:Name
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

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