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 |
значение по умолчанию: | 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-AzureResourceGroupGalleryTemplate.
Тип: | 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
Определяет измененную среду. Этот параметр является обязательным. Значение параметра учитывает регистр. Подстановочные знаки не допускаются.
Тип: | 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