你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Add-AzureEnvironment

创建 Azure 环境。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

Default (默认值)

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 cmdlet 创建新的自定义 Azure 帐户环境,并将其保存在漫游用户配置文件中。 该 cmdlet 返回一个表示新环境的对象。 命令完成后,可以在 Windows PowerShell 中使用环境。

Azure 环境独立于 azure 部署Microsoft,例如 AzureCloud for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

只有此 cmdlet 的 Name 参数是必需的。 如果省略参数,则其值为 null($Null),并且使用该终结点的服务可能无法正常工作。 若要添加或更改环境属性的值,请使用 Set-AzureEnvironment cmdlet。

注意:更改环境可能会导致帐户失败。 通常,仅添加用于测试或故障排除的环境。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 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               :

此命令创建 ContosoEnv Azure 环境。

参数

-ActiveDirectoryEndpoint

在新环境中指定Microsoft Entra 身份验证的终结点。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ActiveDirectoryServiceEndpointResourceId

指定Microsoft Entra ID 管理其访问权限的管理 API 的资源 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-AdTenant

Add-AzureEnvironment cmdlet 创建新的自定义 Azure 帐户环境,并将其保存在漫游用户配置文件中。 该 cmdlet 返回一个表示新环境的对象。 命令完成后,可以在 Windows PowerShell 中使用环境。

Azure 环境独立于 azure 部署Microsoft,例如 AzureCloud for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

只有此 cmdlet 的 Name 参数是必需的。 如果省略参数,则其值为 null($Null),并且使用该终结点的服务可能无法正常工作。 若要添加或更改环境属性的值,请使用 Set-AzureEnvironment cmdlet。

注意:更改环境可能会导致帐户失败。 通常,仅添加用于测试或故障排除的环境。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-AzureKeyVaultDnsSuffix

Add-AzureEnvironment cmdlet 创建新的自定义 Azure 帐户环境,并将其保存在漫游用户配置文件中。 该 cmdlet 返回一个表示新环境的对象。 命令完成后,可以在 Windows PowerShell 中使用环境。

Azure 环境独立于 azure 部署Microsoft,例如 AzureCloud for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

只有此 cmdlet 的 Name 参数是必需的。 如果省略参数,则其值为 null($Null),并且使用该终结点的服务可能无法正常工作。 若要添加或更改环境属性的值,请使用 Set-AzureEnvironment cmdlet。

注意:更改环境可能会导致帐户失败。 通常,仅添加用于测试或故障排除的环境。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-AzureKeyVaultServiceEndpointResourceId

Add-AzureEnvironment cmdlet 创建新的自定义 Azure 帐户环境,并将其保存在漫游用户配置文件中。 该 cmdlet 返回一个表示新环境的对象。 命令完成后,可以在 Windows PowerShell 中使用环境。

Azure 环境独立于 azure 部署Microsoft,例如 AzureCloud for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

只有此 cmdlet 的 Name 参数是必需的。 如果省略参数,则其值为 null($Null),并且使用该终结点的服务可能无法正常工作。 若要添加或更改环境属性的值,请使用 Set-AzureEnvironment cmdlet。

注意:更改环境可能会导致帐户失败。 通常,仅添加用于测试或故障排除的环境。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-EnableAdfsAuthentication

Add-AzureEnvironment cmdlet 创建新的自定义 Azure 帐户环境,并将其保存在漫游用户配置文件中。 该 cmdlet 返回一个表示新环境的对象。 命令完成后,可以在 Windows PowerShell 中使用环境。

Azure 环境独立于 azure 部署Microsoft,例如 AzureCloud for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

只有此 cmdlet 的 Name 参数是必需的。 如果省略参数,则其值为 null($Null),并且使用该终结点的服务可能无法正常工作。 若要添加或更改环境属性的值,请使用 Set-AzureEnvironment cmdlet。

注意:更改环境可能会导致帐户失败。 通常,仅添加用于测试或故障排除的环境。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:OnPremise

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-GalleryEndpoint

指定存储资源组库模板的 Azure 资源管理器 库的终结点。 有关 Azure 资源组和库模板的详细信息,请参阅 Get-AzureResourceGroupGalleryTemplate 的帮助主题https://go.microsoft.com/fwlink/?LinkID=393052.

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:库, 画廊链接

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-GraphEndpoint

Add-AzureEnvironment cmdlet 创建新的自定义 Azure 帐户环境,并将其保存在漫游用户配置文件中。 该 cmdlet 返回一个表示新环境的对象。 命令完成后,可以在 Windows PowerShell 中使用环境。

Azure 环境独立于 azure 部署Microsoft,例如 AzureCloud for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

只有此 cmdlet 的 Name 参数是必需的。 如果省略参数,则其值为 null($Null),并且使用该终结点的服务可能无法正常工作。 若要添加或更改环境属性的值,请使用 Set-AzureEnvironment cmdlet。

注意:更改环境可能会导致帐户失败。 通常,仅添加用于测试或故障排除的环境。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:Graph, GraphUrl

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ManagementPortalUrl

在新环境中指定 Azure 管理门户的 URL。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Name

指定环境的名称。 此参数是必需的。 请勿使用默认环境、AzureCloud 和 AzureChinaCloud 的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

参数属性

类型:AzureSMProfile
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PublishSettingsFileUrl

指定帐户的发布设置文件的 URL。 Azure 发布设置文件是一个 XML 文件,其中包含有关帐户的信息和管理证书,允许 Windows PowerShell 代表你登录到 Azure 帐户。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ResourceManagerEndpoint

指定 Azure 资源管理器数据的终结点,包括与帐户关联的资源组的相关数据。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:ResourceManager, ResourceManagerUrl

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ServiceEndpoint

指定 Azure 服务终结点的 URL。 Azure 服务终结点确定应用程序是由全球 Azure 平台、中国世纪互联运营的 Azure 还是专用 Azure 安装进行管理。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:ServiceManagement, ServiceManagementUrl

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-SqlDatabaseDnsSuffix

Add-AzureEnvironment cmdlet 创建新的自定义 Azure 帐户环境,并将其保存在漫游用户配置文件中。 该 cmdlet 返回一个表示新环境的对象。 命令完成后,可以在 Windows PowerShell 中使用环境。

Azure 环境独立于 azure 部署Microsoft,例如 AzureCloud for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

只有此 cmdlet 的 Name 参数是必需的。 如果省略参数,则其值为 null($Null),并且使用该终结点的服务可能无法正常工作。 若要添加或更改环境属性的值,请使用 Set-AzureEnvironment cmdlet。

注意:更改环境可能会导致帐户失败。 通常,仅添加用于测试或故障排除的环境。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-StorageEndpoint

在新环境中指定存储服务的默认终结点。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:StorageEndpointSuffix

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TrafficManagerDnsSuffix

Add-AzureEnvironment cmdlet 创建新的自定义 Azure 帐户环境,并将其保存在漫游用户配置文件中。 该 cmdlet 返回一个表示新环境的对象。 命令完成后,可以在 Windows PowerShell 中使用环境。

Azure 环境独立于 azure 部署Microsoft,例如 AzureCloud for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

只有此 cmdlet 的 Name 参数是必需的。 如果省略参数,则其值为 null($Null),并且使用该终结点的服务可能无法正常工作。 若要添加或更改环境属性的值,请使用 Set-AzureEnvironment cmdlet。

注意:更改环境可能会导致帐户失败。 通常,仅添加用于测试或故障排除的环境。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

None

可以通过属性名称(而不是值)通过管道将输入传递给此 cmdlet。

输出

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment