Поделиться через


Get-AzureSubscription

Возвращает подписки Azure в учетной записи Azure.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

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

Описание

Командлет Get-AzureSubscription получает подписки в учетной записи Azure. Этот командлет можно использовать для получения сведений о подписке и передачи подписки другим командлетам.

Get-AzureSubscription требует доступа к учетным записям Azure. Перед запуском Get-AzureSubscription необходимо запустить командлет Add-AzureAccount или командлеты, скачивающие и устанавливающие файл параметров публикации (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile.

В этом разделе описывается командлет в версии 0.8.10 модуля Microsoft Azure PowerShell. Чтобы получить версию используемого модуля, в консоли Azure PowerShell введите (Get-Module -Name Azure).Version.

Примеры

Пример 1. Получение всех подписок

C:\PS>Get-AzureSubscription

Эта команда получает все подписки в учетной записи.

Пример 2. Получение подписки по имени

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

Эта команда получает только подписку MyProdSubsciption.

Пример 3. Получение подписки по умолчанию

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

Эта команда получает только имя подписки по умолчанию. Сначала команда получает подписку, а затем использует метод dot для получения свойства SubscriptionName подписки.

Пример 4. Получение свойств выбранной подписки

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

Эта команда возвращает список с именем и сертификатом текущей подписки. Для получения текущей подписки используется команда Get-AzureSubscription . Затем она передает подписку команде Format-List , отображающей выбранные свойства в списке.

Пример 5. Использование альтернативного файла данных подписки

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

Эта команда получает подписки из файла данных данных подписки C:\Temp\MySubscriptions.xml. Используйте параметр SubscriptionDataFile, если вы указали альтернативный файл данных подписки при выполнении командлетов Add-AzureAccount или Import-PublishSettingsFile.

Параметры

-Current

Получает только текущую подписку, то есть подписку, назначенную как "текущая". По умолчанию Get-AzureSubscription получает все подписки в учетных записях Azure. Чтобы назначить подписку текущей, используйте текущий параметр командлета Select-AzureSubscription .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Default

Получает только подписку по умолчанию, то есть подписку, указанную как "по умолчанию". По умолчанию Get-AzureSubscription получает все подписки в учетных записях Azure. Чтобы назначить подписку как "по умолчанию", используйте параметр По умолчанию командлета Select-AzureSubscription .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ExtendedDetails

Возвращает сведения о квоте для подписки в дополнение к стандартным параметрам.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Тип:AzureSMProfile
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SubscriptionId

Тип:String
Aliases:Id
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SubscriptionName

Возвращает только указанную подписку. Введите имя подписки. Для этого значения учитывается регистр. Подстановочные знаки не поддерживаются. По умолчанию Get-AzureSubscription получает все подписки в учетных записях Azure.

Тип:String
Aliases:Name
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Входные данные

None

Входные данные можно передать в свойство SubscriptionName по имени, но не по значению.

Выходные данные

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription

Примечания

  • Get-AzureSubscription получает данные из файла данных подписки, создаваемых командлетами Add-AzureAccount и Import-PublishSettingsFile .