Udostępnij przez

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 zarządzania usługami. Zobacz moduł Az programu PowerShell, aby uzyskać polecenia cmdlet do zarządzania zasobami usługi Azure Resource Manager.

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 .

Type:SwitchParameter
Position:Named
Default value:None
Required: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExtendedDetails

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

Type:SwitchParameter
Position:Named
Default value:None
Required: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.

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

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.

Type:String
Aliases:Name
Position:Named
Default value:None
Required: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 .