Get-AzureSubscription
Ruft Azure-Abonnements in Azure-Konto ab.
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
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-AzureSubscriptionDieser 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).SubscriptionNameDieser 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, CertificateDieser 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 Datendatei "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 .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExtendedDetails
Gibt Kontingentinformationen für das Abonnement zusätzlich zu den Standardeinstellungen 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: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.