Get-AzureSubscription
Hiermee haalt u Azure-abonnementen op in het Azure-account.
Notitie
De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.
De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.
Syntaxis
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>]
Description
De cmdlet Get-AzureSubscription haalt de abonnementen op in uw Azure-account. U kunt deze cmdlet gebruiken om informatie over het abonnement op te halen en om het abonnement door te sturen naar andere cmdlets.
Get-AzureSubscription vereist toegang tot uw Azure-accounts. Voordat u Get-AzureSubscription uitvoert, moet u de cmdlet Add-AzureAccount of de cmdlets uitvoeren die een publicatie-instellingenbestand downloaden en installeren (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile).
In dit onderwerp wordt de cmdlet in de versie 0.8.10 van de Microsoft Azure PowerShell-module beschreven.
Als u de versie van de module wilt ophalen die u gebruikt, typt (Get-Module -Name Azure).Version
u in de Azure PowerShell-console.
Voorbeelden
Voorbeeld 1: Alle abonnementen ophalen
C:\PS>Get-AzureSubscription
Met deze opdracht worden alle abonnementen in het account ophaalt.
Voorbeeld 2: Een abonnement op naam ophalen
C:\PS>Get-AzureSubscription -SubscriptionName "MyProdSubscription"
Met deze opdracht wordt alleen het abonnement 'MyProdSubsciption' opgehaald.
Voorbeeld 3: Het standaardabonnement ophalen
C:\PS>(Get-AzureSubscription -Default).SubscriptionName
Met deze opdracht wordt alleen de naam van het standaardabonnement opgehaald. Met de opdracht wordt eerst het abonnement opgehaald en vervolgens de puntmethode gebruikt om de eigenschap SubscriptionName van het abonnement op te halen.
Voorbeeld 4: Geselecteerde abonnementseigenschappen ophalen
C:\PS>Get-AzureSubscription -Current | Format-List -Property SubscriptionName, Certificate
Met deze opdracht wordt een lijst geretourneerd met de naam en het certificaat van het huidige abonnement. Er wordt een Get-AzureSubscription-opdracht gebruikt om het huidige abonnement op te halen. Vervolgens wordt het abonnement uitgevoerd op een opdracht Indelingslijst waarmee de geselecteerde eigenschappen in een lijst worden weergegeven.
Voorbeeld 5: Een alternatief abonnementsgegevensbestand gebruiken
C:\PS>Get-AzureSubscription -SubscriptionDataFile "C:\Temp\MySubscriptions.xml"
Met deze opdracht worden abonnementen opgehaald uit het gegevensbestand C:\Temp\MySubscriptions.xml abonnement. Gebruik de parameter SubscriptionDataFile als u een alternatief abonnementsgegevensbestand hebt opgegeven toen u de cmdlets Add-AzureAccount of Import-PublishSettingsFile uitvoerde.
Parameters
-Current
Hiermee wordt alleen het huidige abonnement opgehaald, dat wil zeggen het abonnement dat is aangeduid als 'actueel'. Get-AzureSubscription haalt standaard alle abonnementen in uw Azure-accounts op. Als u een abonnement wilt aanwijzen als 'current', gebruikt u de huidige parameter van de cmdlet Select-AzureSubscription .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Default
Hiermee wordt alleen het standaardabonnement opgehaald, dat wil zeggen, het abonnement dat is aangewezen als 'standaard'. Get-AzureSubscription haalt standaard alle abonnementen in uw Azure-accounts op. Als u een abonnement als 'standaard' wilt aanwijzen, gebruikt u de standaardparameter van de cmdlet Select-AzureSubscription .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ExtendedDetails
Retourneert quotumgegevens voor het abonnement, naast de standaardinstellingen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Profile
Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-SubscriptionId
Type: | String |
Aliassen: | Id |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-SubscriptionName
Hiermee wordt alleen het opgegeven abonnement opgehaald. Voer de abonnementsnaam in. De waarde is hoofdlettergevoelig. Jokertekens worden niet ondersteund. Get-AzureSubscription haalt standaard alle abonnementen in uw Azure-accounts op.
Type: | String |
Aliassen: | Name |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
Invoerwaarden
None
U kunt invoer doorsluisen naar de eigenschap SubscriptionName op naam, maar niet op waarde.
Uitvoerwaarden
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription
Notities
- Get-AzureSubscription haalt gegevens op uit het abonnementsgegevensbestand dat de cmdlets Add-AzureAccount en Import-PublishSettingsFile maken.