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

Add-AzureTrafficManagerEndpoint

将终结点添加到流量管理员配置文件。

注意

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

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

语法

Add-AzureTrafficManagerEndpoint
   -DomainName <String>
   [-Location <String>]
   -Type <String>
   -Status <String>
   [-Weight <Int32>]
   [-MinChildEndpoints <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

说明

Add-AzureTrafficManagerEndpoint cmdlet 向Microsoft Azure 流量管理器配置文件添加终结点。 添加终结点后,使用管道运算符将结果 传递给 Set-AzureTrafficManagerProfile cmdlet。 该 cmdlet 连接到 Azure 以保存更改。

示例

示例 1:向配置文件添加终结点

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Add-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "Contoso02App.cloudapp.net" -Status "Enabled" -Type "CloudService" | Set-AzureTrafficManagerProfile

第一个命令使用 Get-AzureTrafficManagerProfile cmdlet 获取名为 ContosoProfile 的配置文件,然后将其存储在$TrafficManagerProfile变量中。

第二个命令将终结点添加到存储在$TrafficManagerProfile中的流量管理员配置文件。 终结点具有域名 Contoso02App.couldapp.net。 该命令还指定是否启用它及其类型。 该命令将配置文件对象传递给 Set-AzureTrafficManagerProfile cmdlet 以连接到 Azure 以保存更改。

示例 2:添加具有指定位置和权重的终结点

PS C:\>Add-AzureTrafficManagerEndpoint -TrafficManagerProfile ContosoTrafficManagerProfile -DomainName " Contoso02App.cloudapp.net" -Status Enabled -Type CloudService -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

此命令将终结点添加到流量管理员配置文件。 终结点具有域名 Contoso02App.couldapp.net。 该命令还指定是否启用它及其类型。 该命令还指定终结点的权重和位置。 该命令将配置文件对象传递给 Set-AzureTrafficManagerProfile 以连接到 Azure 以保存更改。

参数

-DomainName

指定要添加的终结点的域名。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Location

指定 cmdlet 添加的终结点的位置。 这必须是 Azure 位置。

此参数必须包含配置文件中类型为“Any”或类型为“TrafficManager”的终结点的值,该配置文件的负载均衡方法设置为“性能”。 可能的值是 Azure 区域名称,如以下位置 https://azure.microsoft.com/regions/所示。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MinChildEndpoints

指定嵌套配置文件必须联机的最小终结点数,以便将此终结点视为联机。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Profile

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

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Status

指定监视终结点的状态。 有效值为:

  • 已启用
  • 已禁用

如果指定“已启用”值,流量管理员监视终结点,负载均衡方法在管理流量时会考虑它。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-TrafficManagerProfile

指定要向其添加终结点的流量管理员配置文件对象。

类型:IProfileWithDefinition
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Type

指定终结点的类型。 有效值为:

  • CloudService

  • AzureWebsite

  • TrafficManager

  • 任意

如果有多个 AzureWebsite 终结点,则终结点必须位于不同的数据中心。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Weight

指定 cmdlet 添加的终结点的权重。 此参数的有效值范围为 [1,1000]。

此参数仅用于 RoundRobin 负载均衡策略。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输出

Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition

此 cmdlet 生成一个流量管理员配置文件对象,其中包含有关更新的配置文件的信息。