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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

Syntax

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>]

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 Abonnementdatendatei "Subscriptions.xml" anstelle der Standardmäßigen Abonnementdatendatei.

Parameter

-Account

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Current

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Default

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoCurrent

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoDefault

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Type:String
Aliases:Id
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionName

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

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.