Dela via

Get-AzureSubscription

  • Referens
Modul:
Azure

Hämtar Azure-prenumerationer i Azure-konto.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med 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>]

Description

Cmdleten Get-AzureSubscription hämtar prenumerationerna i ditt Azure-konto. Du kan använda den här cmdleten för att hämta information om prenumerationen och skicka prenumerationen till andra cmdletar.

Get-AzureSubscription kräver åtkomst till dina Azure-konton. Innan du kör Get-AzureSubscription måste du köra cmdleten Add-AzureAccount eller cmdletarna som laddar ned och installerar en fil för publiceringsinställningar (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile.

Det här avsnittet beskriver cmdleten i 0.8.10-versionen av Microsoft Azure PowerShell-modulen. Om du vill hämta den version av modulen som du använder skriver (Get-Module -Name Azure).Versiondu i Azure PowerShell-konsolen .

Exempel

Exempel 1: Hämta alla prenumerationer

C:\PS>Get-AzureSubscription

Det här kommandot hämtar alla prenumerationer i kontot.

Exempel 2: Hämta en prenumeration efter namn

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

Det här kommandot hämtar bara prenumerationen "MyProdSubsciption".

Exempel 3: Hämta standardprenumerationen

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

Det här kommandot hämtar bara namnet på standardprenumerationen. Kommandot hämtar först prenumerationen och använder sedan dot-metoden för att hämta egenskapen SubscriptionName för prenumerationen.

Exempel 4: Hämta valda prenumerationsegenskaper

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

Det här kommandot returnerar en lista med namnet och certifikatet för den aktuella prenumerationen. Den använder ett Get-AzureSubscription-kommando för att hämta den aktuella prenumerationen. Sedan skickas prenumerationen till ett Format-List-kommando som visar de valda egenskaperna i en lista.

Exempel 5: Använd en alternativ prenumerationsdatafil

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

Det här kommandot hämtar prenumerationer från datafilen C:\Temp\MySubscriptions.xml prenumeration. Använd parametern SubscriptionDataFile om du angav en alternativ prenumerationsdatafil när du körde cmdletarna Add-AzureAccount eller Import-PublishSettingsFile .

Parametrar

-Current

Hämtar endast den aktuella prenumerationen, det vill: den prenumeration som har angetts som "aktuell". Som standard hämtar Get-AzureSubscription alla prenumerationer på dina Azure-konton. Om du vill ange en prenumeration som "aktuell" använder du parametern Aktuell i cmdleten Select-AzureSubscription .

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Default

Hämtar endast standardprenumerationen, det vill: den prenumeration som har angetts som "standard". Som standard hämtar Get-AzureSubscription alla prenumerationer på dina Azure-konton. Om du vill ange en prenumeration som "standard" använder du standardparametern för cmdleten Select-AzureSubscription .

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExtendedDetails

Returnerar kvotinformation för prenumerationen utöver standardinställningarna.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubscriptionId

Typ:String
Alias:Id
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SubscriptionName

Hämtar endast den angivna prenumerationen. Ange prenumerationsnamnet. Värdet är skiftlägeskänsligt. Jokertecken stöds inte. Som standard hämtar Get-AzureSubscription alla prenumerationer på dina Azure-konton.

Typ:String
Alias:Name
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

None

Du kan skicka indata till egenskapen SubscriptionName efter namn, men inte efter värde.

Utdata

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription

Kommentarer

  • Get-AzureSubscription hämtar data från prenumerationsdatafilen som cmdletarna Add-AzureAccount och Import-PublishSettingsFile skapar.