Get-AzureEnvironment
Возвращает среды Azure
Примечание.
Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.
Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.
Синтаксис
Get-AzureEnvironment
[-Name <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Описание
Командлет Get-AzureEnvironment получает среды Azure, доступные Для Windows PowerShell.
Среда Azure независимое развертывание Microsoft Azure, например AzureCloud для глобальной среды Azure и AzureChinaCloud для Azure под управлением 21Vianet в Китае. Вы также можете создавать локальные среды Azure с помощью Azure Pack и командлетов WAPack. Дополнительные сведения см. в пакете Azure.
Командлет Get-AzureEnvironment получает среды из файла данных подписки, а не из Azure. Если файл данных подписки устарел, выполните командлет Add-AzureAccount или Import-PublishSettingsFile , чтобы обновить его.
В этом разделе описывается командлет в версии 0.8.10 модуля Microsoft Azure PowerShell.
Чтобы получить версию используемого модуля, в консоли Azure PowerShell введите (Get-Module -Name Azure).Version
.
Примеры
Пример 1. Получение всех сред
PS C:\> Get-AzureEnvironment
EnvironmentName ServiceEndpoint ResourceManagerEndpoint PublishSettingsFileUrl
--------------- --------------- ----------------------- ----------------------
AzureCloud https://management.core.wi... https://management.azure.com/ https://go.microsoft.com/fw...
AzureChinaCloud https://management.core.ch... https://not-supported-serv... https://go.microsoft.com/fw...
Эта команда получает все среды, доступные в Windows PowerShell.
Пример 2. Получение среды по имени
PS C:\> Get-AzureEnvironment -Name AzureCloud
Name : AzureCloud
PublishSettingsFileUrl : https://go.microsoft.com/fwlink/?LinkID=301775
ServiceEndpoint : https://management.core.windows.net/
ResourceManagerEndpoint : https://management.azure.com/
ManagementPortalUrl : https://go.microsoft.com/fwlink/?LinkId=254433
ActiveDirectoryEndpoint : https://login.windows.net/
ActiveDirectoryCommonTenantId : common
StorageEndpointSuffix : core.windows.net
StorageBlobEndpointFormat : {0}://{1}.blob.core.windows.net/
StorageQueueEndpointFormat : {0}://{1}.queue.core.windows.net/
StorageTableEndpointFormat : {0}://{1}.table.core.windows.net/
GalleryEndpoint : https://gallery.azure.com/
В этом примере получается среда AzureCloud.
Пример 3. Получение всех свойств всех сред
PS C:\> Get-AzureEnvironment | ForEach-Object {Get-AzureEnvironment -Name $_.EnvironmentName}
Эта команда получает все свойства всех сред.
Команда использует командлет Get-AzureEnvironment для получения всех сред Azure для этой учетной записи. Затем он использует командлет Foreach-Object для выполнения команды Get-AzureEnvironment с параметром Name в каждой среде. Значение параметра Name — свойство EnvironmentName каждой среды.
Без параметров Get-AzureEnvironment получает только выбранные свойства среды.
Параметры
-Name
Возвращает только указанную среду. Введите имя среды. Значение параметра учитывает регистр. Подстановочные знаки не допускаются.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Profile
Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.
Тип: | AzureSMProfile |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Входные данные можно передать в этот командлет по имени свойства, но не по значению.
Выходные данные
По умолчанию Get-AzureEnvironment возвращает пользовательский объект.
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment
При запуске Get-AzureEnvironment с параметром Name он возвращает объект WindowsAzureEnvironment.