Freigeben über


Select-AzureSubscription

Ändert die aktuellen und standardmäßigen Azure-Abonnements.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

SelectSubscriptionByNameParameterSet (Standardwert)

Select-AzureSubscription
    -SubscriptionName <String>
    [-Account <String>]
    [-Current]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

SelectDefaultSubscriptionByNameParameterSet

Select-AzureSubscription
    -SubscriptionName <String>
    [-Account <String>]
    [-Default]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

SelectSubscriptionByIdParameterSet

Select-AzureSubscription
    -SubscriptionId <String>
    [-Account <String>]
    [-Current]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

SelectDefaultSubscriptionByIdParameterSet

Select-AzureSubscription
    -SubscriptionId <String>
    [-Account <String>]
    [-Default]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

NoCurrentSubscriptionParameterSet

Select-AzureSubscription
    [-Account <String>]
    [-NoCurrent]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

NoDefaultSubscriptionParameterSet

Select-AzureSubscription
    [-Account <String>]
    [-NoDefault]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Select-AzureSubscription legt die aktuellen und standardmäßigen Azure-Abonnements fest und löscht sie.

Das "aktuelle Abonnement" ist das Abonnement, das standardmäßig in der aktuellen Windows PowerShell-Sitzung verwendet wird. Das "Standardabonnement" wird standardmäßig in allen Windows PowerShell-Sitzungen verwendet. Mit der Bezeichnung "Aktuelles Abonnement" können Sie ein anderes Abonnement angeben, das standardmäßig für die aktuelle Sitzung verwendet werden soll, ohne das Standardabonnement für alle anderen Sitzungen zu ändern.

Die Bezeichnung des "Standardabonnements" wird in Ihrer Abonnementdatendatei gespeichert. Die sitzungsspezifische "aktuelle" Bezeichnung wird nicht gespeichert.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Beispiele

Beispiel 1: Festlegen des aktuellen Abonnements

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

Mit diesem Befehl wird "Contoso Engineering" zum aktuellen Abonnement.

Beispiel 2: Festlegen des Standardabonnements

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

Mit diesem Befehl wird das Standardabonnement in "ContosoFinance" geändert. Sie speichert die Einstellung in der Subscriptions.xml Abonnementdatendatei anstelle der Standardabonnementdatendatei.

Parameter

-Account

Das Cmdlet Select-AzureSubscription legt die aktuellen und standardmäßigen Azure-Abonnements fest und löscht sie.

Das "aktuelle Abonnement" ist das Abonnement, das standardmäßig in der aktuellen Windows PowerShell-Sitzung verwendet wird. Das "Standardabonnement" wird standardmäßig in allen Windows PowerShell-Sitzungen verwendet. Mit der Bezeichnung "Aktuelles Abonnement" können Sie ein anderes Abonnement angeben, das standardmäßig für die aktuelle Sitzung verwendet werden soll, ohne das Standardabonnement für alle anderen Sitzungen zu ändern.

Die Bezeichnung des "Standardabonnements" wird in Ihrer Abonnementdatendatei gespeichert. Die sitzungsspezifische "aktuelle" Bezeichnung wird nicht gespeichert.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Current

Das Cmdlet Select-AzureSubscription legt die aktuellen und standardmäßigen Azure-Abonnements fest und löscht sie.

Das "aktuelle Abonnement" ist das Abonnement, das standardmäßig in der aktuellen Windows PowerShell-Sitzung verwendet wird. Das "Standardabonnement" wird standardmäßig in allen Windows PowerShell-Sitzungen verwendet. Mit der Bezeichnung "Aktuelles Abonnement" können Sie ein anderes Abonnement angeben, das standardmäßig für die aktuelle Sitzung verwendet werden soll, ohne das Standardabonnement für alle anderen Sitzungen zu ändern.

Die Bezeichnung des "Standardabonnements" wird in Ihrer Abonnementdatendatei gespeichert. Die sitzungsspezifische "aktuelle" Bezeichnung wird nicht gespeichert.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SelectSubscriptionByNameParameterSet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
SelectSubscriptionByIdParameterSet
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Default

Das Cmdlet Select-AzureSubscription legt die aktuellen und standardmäßigen Azure-Abonnements fest und löscht sie.

Das "aktuelle Abonnement" ist das Abonnement, das standardmäßig in der aktuellen Windows PowerShell-Sitzung verwendet wird. Das "Standardabonnement" wird standardmäßig in allen Windows PowerShell-Sitzungen verwendet. Mit der Bezeichnung "Aktuelles Abonnement" können Sie ein anderes Abonnement angeben, das standardmäßig für die aktuelle Sitzung verwendet werden soll, ohne das Standardabonnement für alle anderen Sitzungen zu ändern.

Die Bezeichnung des "Standardabonnements" wird in Ihrer Abonnementdatendatei gespeichert. Die sitzungsspezifische "aktuelle" Bezeichnung wird nicht gespeichert.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SelectDefaultSubscriptionByNameParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
SelectDefaultSubscriptionByIdParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NoCurrent

Das Cmdlet Select-AzureSubscription legt die aktuellen und standardmäßigen Azure-Abonnements fest und löscht sie.

Das "aktuelle Abonnement" ist das Abonnement, das standardmäßig in der aktuellen Windows PowerShell-Sitzung verwendet wird. Das "Standardabonnement" wird standardmäßig in allen Windows PowerShell-Sitzungen verwendet. Mit der Bezeichnung "Aktuelles Abonnement" können Sie ein anderes Abonnement angeben, das standardmäßig für die aktuelle Sitzung verwendet werden soll, ohne das Standardabonnement für alle anderen Sitzungen zu ändern.

Die Bezeichnung des "Standardabonnements" wird in Ihrer Abonnementdatendatei gespeichert. Die sitzungsspezifische "aktuelle" Bezeichnung wird nicht gespeichert.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NoCurrentSubscriptionParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NoDefault

Das Cmdlet Select-AzureSubscription legt die aktuellen und standardmäßigen Azure-Abonnements fest und löscht sie.

Das "aktuelle Abonnement" ist das Abonnement, das standardmäßig in der aktuellen Windows PowerShell-Sitzung verwendet wird. Das "Standardabonnement" wird standardmäßig in allen Windows PowerShell-Sitzungen verwendet. Mit der Bezeichnung "Aktuelles Abonnement" können Sie ein anderes Abonnement angeben, das standardmäßig für die aktuelle Sitzung verwendet werden soll, ohne das Standardabonnement für alle anderen Sitzungen zu ändern.

Die Bezeichnung des "Standardabonnements" wird in Ihrer Abonnementdatendatei gespeichert. Die sitzungsspezifische "aktuelle" Bezeichnung wird nicht gespeichert.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NoDefaultSubscriptionParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt $True zurück, wenn der Befehl erfolgreich ist, und $False, wenn er fehlschlägt. Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Parametereigenschaften

Typ:AzureSMProfile
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubscriptionId

Das Cmdlet Select-AzureSubscription legt die aktuellen und standardmäßigen Azure-Abonnements fest und löscht sie.

Das "aktuelle Abonnement" ist das Abonnement, das standardmäßig in der aktuellen Windows PowerShell-Sitzung verwendet wird. Das "Standardabonnement" wird standardmäßig in allen Windows PowerShell-Sitzungen verwendet. Mit der Bezeichnung "Aktuelles Abonnement" können Sie ein anderes Abonnement angeben, das standardmäßig für die aktuelle Sitzung verwendet werden soll, ohne das Standardabonnement für alle anderen Sitzungen zu ändern.

Die Bezeichnung des "Standardabonnements" wird in Ihrer Abonnementdatendatei gespeichert. Die sitzungsspezifische "aktuelle" Bezeichnung wird nicht gespeichert.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Id

Parametersätze

SelectSubscriptionByIdParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
SelectDefaultSubscriptionByIdParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SubscriptionName

Das Cmdlet Select-AzureSubscription legt die aktuellen und standardmäßigen Azure-Abonnements fest und löscht sie.

Das "aktuelle Abonnement" ist das Abonnement, das standardmäßig in der aktuellen Windows PowerShell-Sitzung verwendet wird. Das "Standardabonnement" wird standardmäßig in allen Windows PowerShell-Sitzungen verwendet. Mit der Bezeichnung "Aktuelles Abonnement" können Sie ein anderes Abonnement angeben, das standardmäßig für die aktuelle Sitzung verwendet werden soll, ohne das Standardabonnement für alle anderen Sitzungen zu ändern.

Die Bezeichnung des "Standardabonnements" wird in Ihrer Abonnementdatendatei gespeichert. Die sitzungsspezifische "aktuelle" Bezeichnung wird nicht gespeichert.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Name

Parametersätze

SelectSubscriptionByNameParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
SelectDefaultSubscriptionByNameParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.

Ausgaben

None or System.Boolean

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet einen booleschen Wert zurück. Standardmäßig wird keine Ausgabe generiert.