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 .