你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureEnvironment
更改 Azure 环境的属性。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (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 cmdlet 更改 Azure 环境的属性。 它返回一个对象，该对象代表具有其新属性值的环境。 使用 Name 参数标识环境和其他参数以更改属性值。 不能使用 Set-AzureEnvironment 更改 Azure 环境的名称。
Azure 环境独立于 azure 部署Microsoft，例如 AzureCloud for global Azure，以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息，请参阅 Azure Pack。
注意：不要更改 AzureCloud 或 AzureChinaCloud 环境的属性。 使用此 cmdlet 更改创建的专用环境的值。
示例
示例 1：更改环境属性
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"此命令更改 ContosoEnv 环境的 PublishSettingsFileUrl 和 StorageEndpoint 属性的值。
参数
-ActiveDirectoryEndpoint
将Microsoft Entra 身份验证的终结点更改为指定值。
| 类型: | String |
| 别名: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ActiveDirectoryServiceEndpointResourceId
指定Microsoft Entra ID 管理其访问权限的管理 API 的资源 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-AdTenant
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-AzureKeyVaultDnsSuffix
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-AzureKeyVaultServiceEndpointResourceId
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-EnableAdfsAuthentication
| 类型: | SwitchParameter |
| 别名: | OnPremise |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-GalleryEndpoint
将 Azure 资源管理器 库的终结点更改为指定值。 库终结点是资源组库模板的位置。 有关 Azure 资源组和库模板的详细信息，请参阅 Get-AzureResourceGroupGalleryTemplate 的帮助主题。
| 类型: | String |
| 别名: | Gallery, GalleryUrl |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-GraphEndpoint
| 类型: | String |
| 别名: | Graph, GraphUrl |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ManagementPortalUrl
将 Azure 管理门户的 URL 更改为指定值。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
标识正在更改的环境。 此参数是必需的。 参数值区分大小写。 不允许使用通配符。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PublishSettingsFileUrl
更改指定环境中的发布设置文件的 URL。 Azure 发布设置文件是一个 XML 文件，其中包含有关帐户的信息和管理证书，允许 Windows PowerShell 代表你登录到 Azure 帐户。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ResourceManagerEndpoint
更改 Azure 资源管理器数据的终结点，包括与帐户关联的资源组的相关数据。 有关 Azure 资源管理器的详细信息，请参阅 Azure 资源管理器 Cmdlet （https://go.microsoft.com/fwlink/?LinkID=394765） 和将 Windows PowerShell 与 资源管理器 配合使用（https://go.microsoft.com/fwlink/?LinkID=394767）。
| 类型: | String |
| 别名: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ServiceEndpoint
更改指定环境中的 Azure 服务终结点的 URL。 Azure 服务终结点确定应用程序是由全球 Azure 平台、中国世纪互联运营的 Azure 还是专用 Azure 安装进行管理。
| 类型: | String |
| 别名: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-SqlDatabaseDnsSuffix
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-StorageEndpoint
更改指定环境中的存储服务的默认终结点。
| 类型: | String |
| 别名: | StorageEndpointSuffix |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-TrafficManagerDnsSuffix
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
输入
None
可以通过属性名称（而不是值）通过管道将输入传递给此 cmdlet。
输出
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment