你当前正在访问 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 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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

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

  • Enabled
  • 已禁用

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

类型: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 生成一个流量管理员配置文件对象,其中包含有关更新的配置文件的信息。