Add-AzureEnvironment
Создает среду Azure.
Примечание.
Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.
Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.
Синтаксис
Add-AzureEnvironment
-Name <String>
[-PublishSettingsFileUrl <String>]
[-ServiceEndpoint <String>]
[-ManagementPortalUrl <String>]
[-StorageEndpoint <String>]
[-ActiveDirectoryEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-GalleryEndpoint <String>]
[-ActiveDirectoryServiceEndpointResourceId <String>]
[-GraphEndpoint <String>]
[-AzureKeyVaultDnsSuffix <String>]
[-AzureKeyVaultServiceEndpointResourceId <String>]
[-TrafficManagerDnsSuffix <String>]
[-SqlDatabaseDnsSuffix <String>]
[-EnableAdfsAuthentication]
[-AdTenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Описание
Командлет Add-AzureEnvironment создает новую настраиваемую среду учетной записи Azure и сохраняет ее в перемещаемом профиле пользователя. Командлет возвращает объект, представляющий новую среду. По завершении команды можно использовать среду в Windows PowerShell.
Среда Azure независимое развертывание Microsoft Azure, например AzureCloud для глобальной среды Azure и AzureChinaCloud для Azure под управлением 21Vianet в Китае. Вы также можете создавать локальные среды Azure с помощью Azure Pack и командлетов WAPack. Дополнительные сведения см. в пакете Azure.
Обязательны только параметр Name этого командлета. Если параметр не указан, его значение равно NULL ($Null), а служба, использующая эту конечную точку, может не работать должным образом. Чтобы добавить или изменить значение свойства среды, используйте командлет Set-AzureEnvironment .
ПРИМЕЧАНИЕ. Изменение среды может привести к сбою учетной записи. Как правило, среды добавляются только для тестирования или устранения неполадок.
В этом разделе описывается командлет в версии 0.8.10 модуля Microsoft Azure PowerShell.
Чтобы получить версию используемого модуля, в консоли Azure PowerShell введите (Get-Module -Name Azure).Version.
Примеры
Пример 1. Добавление среды Azure
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :Эта команда создает среду Azure ContosoEnv.
Параметры
-ActiveDirectoryEndpoint
Указывает конечную точку для проверки подлинности Microsoft Entra в новой среде.
| Тип: | String |
| Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ActiveDirectoryServiceEndpointResourceId
Указывает идентификатор ресурса API управления, доступ к которому управляется идентификатором Microsoft Entra.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-AdTenant
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-AzureKeyVaultDnsSuffix
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-AzureKeyVaultServiceEndpointResourceId
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-EnableAdfsAuthentication
| Тип: | SwitchParameter |
| Aliases: | OnPremise |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-GalleryEndpoint
Указывает конечную точку для коллекции Azure Resource Manager, в которой хранятся шаблоны коллекций групп ресурсов. Дополнительные сведения о группах ресурсов Azure и шаблонах коллекции см. в разделе справки для Get-AzureResourceGroupGalleryTemplatehttps://go.microsoft.com/fwlink/?LinkID=393052.
| Тип: | String |
| Aliases: | Gallery, GalleryUrl |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-GraphEndpoint
| Тип: | String |
| Aliases: | Graph, GraphUrl |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ManagementPortalUrl
Указывает URL-адрес портала управления Azure в новой среде.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Name
Указывает имя среды. Этот параметр является обязательным. Не используйте имена сред по умолчанию, AzureCloud и AzureChinaCloud.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Profile
Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.
| Тип: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PublishSettingsFileUrl
Указывает URL-адрес файлов параметров публикации для учетной записи. Файл параметров публикации Azure — это XML-файл, содержащий сведения о вашей учетной записи и сертификате управления, который позволяет Windows PowerShell войти в учетную запись Azure от вашего имени.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ResourceManagerEndpoint
Указывает конечную точку для данных Azure Resource Manager, включая данные о группах ресурсов, связанных с учетной записью. Дополнительные сведения о Azure Resource Manager см. в разделе "Командлеты Azure Resource Manager" (https://go.microsoft.com/fwlink/?LinkID=394765) и использование Windows PowerShell с Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).
| Тип: | String |
| Aliases: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ServiceEndpoint
Указывает URL-адрес конечной точки службы Azure. Конечная точка службы Azure определяет, управляется ли ваше приложение глобальной платформой Azure, Azure, управляемой 21Vianet в Китае или частной установкой Azure.
| Тип: | String |
| Aliases: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SqlDatabaseDnsSuffix
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-StorageEndpoint
Указывает конечную точку по умолчанию служб хранилища в новой среде.
| Тип: | String |
| Aliases: | StorageEndpointSuffix |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TrafficManagerDnsSuffix
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
Входные данные
None
Входные данные можно передать в этот командлет по имени свойства, но не по значению.
Выходные данные
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment