Udostępnij za pośrednictwem

Get-AzureSubscription

  • Odwołanie
Moduł:
Azure

Pobiera subskrypcje platformy Azure na koncie platformy Azure.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Get-AzureSubscription pobiera subskrypcje na koncie platformy Azure. Tego polecenia cmdlet można użyć do uzyskania informacji o subskrypcji i potoku subskrypcji do innych poleceń cmdlet.

Polecenie Get-AzureSubscription wymaga dostępu do kont platformy Azure. Przed uruchomieniem polecenia Get-AzureSubscription należy uruchomić polecenie cmdlet Add-AzureAccount lub polecenia cmdlet pobierające i instalujące plik ustawień publikowania (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile.

W tym temacie opisano polecenie cmdlet w wersji 0.8.10 modułu Microsoft Azure PowerShell. Aby uzyskać wersję używanego modułu, w konsoli programu Azure PowerShell wpisz (Get-Module -Name Azure).Version.

Przykłady

Przykład 1. Pobieranie wszystkich subskrypcji

C:\PS>Get-AzureSubscription

To polecenie pobiera wszystkie subskrypcje na koncie.

Przykład 2. Pobieranie subskrypcji według nazwy

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

To polecenie pobiera tylko subskrypcję "MyProdSubsciption".

Przykład 3. Pobieranie subskrypcji domyślnej

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

To polecenie pobiera tylko nazwę subskrypcji domyślnej. Polecenie najpierw pobiera subskrypcję, a następnie używa metody kropki, aby uzyskać właściwość SubscriptionName subskrypcji.

Przykład 4. Pobieranie wybranych właściwości subskrypcji

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

To polecenie zwraca listę z nazwą i certyfikatem bieżącej subskrypcji. Używa polecenia Get-AzureSubscription , aby uzyskać bieżącą subskrypcję. Następnie potokuje subskrypcję do polecenia Format-List , które wyświetla wybrane właściwości na liście.

Przykład 5. Używanie alternatywnego pliku danych subskrypcji

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

To polecenie pobiera subskrypcje z pliku danych subskrypcji C:\Temp\MySubscriptions.xml. Użyj parametru SubscriptionDataFile, jeśli określono alternatywny plik danych subskrypcji podczas uruchamiania poleceń cmdlet Add-AzureAccount lub Import-PublishSettingsFile.

Parametry

-Current

Pobiera tylko bieżącą subskrypcję, czyli subskrypcję wyznaczoną jako "current". Domyślnie polecenie Get-AzureSubscription pobiera wszystkie subskrypcje na kontach platformy Azure. Aby wyznaczyć subskrypcję jako "bieżącą", użyj bieżącego parametru polecenia cmdlet Select-AzureSubscription .

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Default

Pobiera tylko domyślną subskrypcję, czyli subskrypcję wyznaczoną jako "domyślną". Domyślnie polecenie Get-AzureSubscription pobiera wszystkie subskrypcje na kontach platformy Azure. Aby wyznaczyć subskrypcję jako "domyślną", użyj domyślnego parametru polecenia cmdlet Select-AzureSubscription.

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-ExtendedDetails

Zwraca informacje o limitach przydziału dla subskrypcji oprócz ustawień standardowych.

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Typ:String
Aliases:Id
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionName

Pobiera tylko określoną subskrypcję. Wprowadź nazwę subskrypcji. Wartość jest uwzględniana w wielkości liter. Symbole wieloznaczne nie są obsługiwane. Domyślnie polecenie Get-AzureSubscription pobiera wszystkie subskrypcje na kontach platformy Azure.

Typ:String
Aliases:Name
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

None

Możesz przekazać dane wejściowe do właściwości SubscriptionName według nazwy, ale nie według wartości.

Dane wyjściowe

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription

Uwagi

  • Polecenie Get-AzureSubscription pobiera dane z pliku danych subskrypcji utworzonego przez polecenia cmdlet Add-AzureAccount i Import-PublishSettingsFile .