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


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
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

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

Тип:AzureSMProfile
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

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

None

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

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

PSCustomObject

По умолчанию Get-AzureEnvironment возвращает пользовательский объект.

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

При запуске Get-AzureEnvironment с параметром Name он возвращает объект WindowsAzureEnvironment.