Set-AzureEnvironment
Изменяет свойства среды Azure.
Примечание.
Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.
Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.
Синтаксис
Set-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>]
Описание
Командлет Set-AzureEnvironment изменяет свойства среды Azure. Он возвращает объект, представляющий среду со своими новыми значениями свойств. Используйте параметр Name для идентификации среды и других параметров для изменения значений свойств. Невозможно использовать Set-AzureEnvironment для изменения имени среды Azure.
Среда Azure независимое развертывание Microsoft Azure, например AzureCloud для глобальной среды Azure и AzureChinaCloud для Azure под управлением 21Vianet в Китае. Вы также можете создавать локальные среды Azure с помощью Azure Pack и командлетов WAPack. Дополнительные сведения см. в пакете Azure.
ПРИМЕЧАНИЕ. Не изменяйте свойства сред AzureCloud или AzureChinaCloud. Используйте этот командлет для изменения значений создаваемых частных сред.
Примеры
Пример 1. Изменение свойств среды
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"
Эта команда изменяет значения свойств PublishSettingsFileUrl и StorageEndpoint среды 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-AzureResourceGroupGalleryTemplate.
Тип: | 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
Определяет измененную среду. Этот параметр является обязательным. Значение параметра учитывает регистр. Подстановочные знаки не допускаются.
Тип: | 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