Freigeben über

Get-AzureSubscription

  • Referenz
Modul:
Azure

Ruft Azure-Abonnements in Azure-Konto ab.

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

Get-AzureSubscription
   [-SubscriptionName <String>]
   [-ExtendedDetails]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSubscription
   [-SubscriptionId <String>]
   [-ExtendedDetails]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSubscription
   [-Default]
   [-ExtendedDetails]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSubscription
   [-Current]
   [-ExtendedDetails]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-AzureSubscription " ruft die Abonnements in Ihrem Azure-Konto ab. Mit diesem Cmdlet können Sie Informationen zum Abonnement abrufen und das Abonnement an andere Cmdlets weiterleiten.

Get-AzureSubscription erfordert Zugriff auf Ihre Azure-Konten. Bevor Sie Get-AzureSubscription ausführen, müssen Sie das Add-AzureAccount-Cmdlet oder die Cmdlets ausführen, die eine Veröffentlichungseinstellungsdatei herunterladen und installieren (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile).

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: Abrufen aller Abonnements

C:\PS>Get-AzureSubscription

Dieser Befehl ruft alle Abonnements im Konto ab.

Beispiel 2: Abrufen eines Abonnements anhand des Namens

C:\PS>Get-AzureSubscription -SubscriptionName "MyProdSubscription"

Dieser Befehl ruft nur das Abonnement "MyProdSubsciption" ab.

Beispiel 3: Abrufen des Standardabonnements

C:\PS>(Get-AzureSubscription -Default).SubscriptionName

Dieser Befehl ruft nur den Namen des Standardabonnements ab. Der Befehl ruft zuerst das Abonnement ab und verwendet dann die Dot-Methode, um die SubscriptionName-Eigenschaft des Abonnements abzurufen.

Beispiel 4: Abrufen ausgewählter Abonnementeigenschaften

C:\PS>Get-AzureSubscription -Current | Format-List -Property SubscriptionName, Certificate

Dieser Befehl gibt eine Liste mit dem Namen und zertifikat des aktuellen Abonnements zurück. Es verwendet einen Get-AzureSubscription-Befehl zum Abrufen des aktuellen Abonnements. Anschließend wird das Abonnement an einen Befehl "Formatliste " gesendet, der die ausgewählten Eigenschaften in einer Liste anzeigt.

Beispiel 5: Verwenden einer alternativen Abonnementdatendatei

C:\PS>Get-AzureSubscription -SubscriptionDataFile "C:\Temp\MySubscriptions.xml"

Dieser Befehl ruft Abonnements aus der Abonnementdatendatei "C:\Temp\MySubscriptions.xml" ab. Verwenden Sie den Parameter "SubscriptionDataFile ", wenn Sie beim Ausführen der Cmdlets "Add-AzureAccount " oder "Import-PublishSettingsFile " eine alternative Abonnementdatendatei angegeben haben.

Parameter

-Current

Ruft nur das aktuelle Abonnement ab, d. a. das Abonnement, das als "aktuell" festgelegt ist. Standardmäßig ruft Get-AzureSubscription alle Abonnements in Ihren Azure-Konten ab. Um ein Abonnement als "aktuell" festzulegen, verwenden Sie den Current-Parameter des Cmdlets Select-AzureSubscription .

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Default

Ruft nur das Standardabonnement ab, d. a. das Abonnement, das als "Standard" festgelegt ist. Standardmäßig ruft Get-AzureSubscription alle Abonnements in Ihren Azure-Konten ab. Um ein Abonnement als "Standard" festzulegen, verwenden Sie den Standardparameter des Cmdlets Select-AzureSubscription .

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExtendedDetails

Gibt Kontingentinformationen für das Abonnement zusätzlich zu den Standardeinstellungen zurück.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

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

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubscriptionId

Typ:String
Aliase:Id
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SubscriptionName

Ruft nur das angegebene Abonnement ab. Geben Sie den Abonnementnamen ein. Bei dem Wert wird die Groß-/Kleinschreibung beachtet. Platzhalterzeichen werden nicht unterstützt. Standardmäßig ruft Get-AzureSubscription alle Abonnements in Ihren Azure-Konten ab.

Typ:String
Aliase:Name
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können Eingaben nach Name an die SubscriptionName-Eigenschaft , aber nicht nach Wert weiterzuleitungen.

Ausgaben

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription

Hinweise

  • Get-AzureSubscription ruft Daten aus der Abonnementdatendatei ab, die von den Cmdlets Add-AzureAccount und Import-PublishSettingsFile erstellt werden.