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 |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ActiveDirectoryServiceEndpointResourceId
Указывает идентификатор ресурса API управления, доступ к которому управляется идентификатором Microsoft Entra.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AdTenant
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AzureKeyVaultDnsSuffix
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AzureKeyVaultServiceEndpointResourceId
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableAdfsAuthentication
Тип: | SwitchParameter |
Aliases: | OnPremise |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GalleryEndpoint
Указывает конечную точку для коллекции Azure Resource Manager, в которой хранятся шаблоны коллекций групп ресурсов. Дополнительные сведения о группах ресурсов Azure и шаблонах коллекции см. в разделе справки для Get-AzureResourceGroupGalleryTemplatehttps://go.microsoft.com/fwlink/?LinkID=393052.
Тип: | String |
Aliases: | Gallery, GalleryUrl |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GraphEndpoint
Тип: | String |
Aliases: | Graph, GraphUrl |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ManagementPortalUrl
Указывает URL-адрес портала управления Azure в новой среде.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Указывает имя среды. Этот параметр является обязательным. Не используйте имена сред по умолчанию, AzureCloud и AzureChinaCloud.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.
Тип: | AzureSMProfile |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublishSettingsFileUrl
Указывает URL-адрес файлов параметров публикации для учетной записи. Файл параметров публикации Azure — это XML-файл, содержащий сведения о вашей учетной записи и сертификате управления, который позволяет Windows PowerShell войти в учетную запись Azure от вашего имени.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceEndpoint
Указывает URL-адрес конечной точки службы Azure. Конечная точка службы Azure определяет, управляется ли ваше приложение глобальной платформой Azure, Azure, управляемой 21Vianet в Китае или частной установкой Azure.
Тип: | String |
Aliases: | ServiceManagement, ServiceManagementUrl |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SqlDatabaseDnsSuffix
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageEndpoint
Указывает конечную точку по умолчанию служб хранилища в новой среде.
Тип: | String |
Aliases: | StorageEndpointSuffix |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrafficManagerDnsSuffix
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Входные данные
None
Входные данные можно передать в этот командлет по имени свойства, но не по значению.
Выходные данные
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment