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

Set-AzureTrafficManagerEndpoint

更新流量管理员配置文件中终结点的属性。

注意

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

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

语法

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

说明

Set-AzureTrafficManagerEndpoint cmdlet 更新Microsoft Azure 流量管理器配置文件中终结点的属性。 如果当前配置文件中不存在终结点,则此 cmdlet 会创建该终结点。 添加终结点后,使用管道运算符将结果 传递给 Set-AzureTrafficManagerProfile cmdlet。 该 cmdlet 连接到 Azure 以保存更改。

示例

示例 1:更新配置文件的终结点

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Set-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "ContosoApp02.cloudapp.net" -Status "Enabled" -Type "CloudService" -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

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

第二个命令更新存储在$TrafficManagerProfile中的流量管理员配置文件中的终结点。 终结点具有域名 ContosoApp02.cloudapp.net。 该命令还指定终结点的状态、类型、权重和位置。 该命令将修改后的配置文件传递给 Set-AzureTrafficManagerProfile cmdlet 以连接到 Azure 以保存更改。

参数

-DomainName

指定要修改的终结点的域名。

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

-Location

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

此参数必须包含配置文件中类型为“Any”或类型为“TrafficManager”的终结点的值,该配置文件的负载均衡方法设置为“性能”。 可能的值是 Azure 区域名称,如以下位置 https://azure.microsoft.com/regions/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
必需:False
接受管道输入:False
接受通配符:False

-TrafficManagerProfile

指定要为其修改终结点的流量管理员配置文件对象。

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

-Type

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

  • CloudService

  • AzureWebsite

  • TrafficManager

  • 任意

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

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

-Weight

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

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

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

输出

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

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