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

Set-AzureTrafficManagerProfile

更新流量管理员配置文件的属性。

注意

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

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

Set-AzureTrafficManagerProfile
   [-Name <String>]
   [-LoadBalancingMethod <String>]
   [-MonitorPort <Int32>]
   [-MonitorProtocol <String>]
   [-MonitorRelativePath <String>]
   [-Ttl <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

说明

Set-AzureTrafficManagerProfile cmdlet 更新Microsoft Azure 流量管理器配置文件的属性。

对于已将 LoadBalancingMethod 值设置为“Failover”的配置文件,可以使用 Add-AzureTrafficManagerEndpoint cmdlet 确定已添加到配置文件中的终结点的故障转移顺序。 有关详细信息,请参阅下面的示例 3。

示例

示例 1:为流量管理员配置文件设置 TTL

PS C:\>Set-AzureTrafficManagerProfile -TrafficManagerProfile $MyTrafficManagerProfile -Ttl 60

此命令将 流量管理员 配置文件对象 MyTrafficManagerProfile 的 TTL 设置为 60 秒。

示例 2:为配置文件设置多个值

PS C:\>Get-AzureTrafficManagerProfile -Name "MyProfile" | Set-AzureTrafficManagerProfile -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"

此命令使用 Get-AzureTrafficManagerProfile cmdlet 获取名为 MyProfile 的流量管理员配置文件。 配置文件使用 RoundRobin 负载均衡方法、TTL 为 30 秒、监视器协议 HTTP、监视器端口和流量管理员配置文件的相对路径。

示例 3:将终结点重新排序到所需的故障转移顺序

PS C:\>$Profile = Get-AzureTrafficManagerProfile -Name "MyProfile"
PS C:\> $Profile.Endpoints[0],$Profile.Endpoints[1] = $Profile.Endpoints[1],$Profile.Endpoints[0]
PS C:\> $Profile = Set-AzureTrafficManagerProfile

此示例将添加到 MyProfile 的终结点重新排序到所需的故障转移顺序。

第一个命令获取名为 MyProfile 的流量管理员配置文件对象,并将对象存储在$Profile变量中。

第二个命令将终结点从终结点数组重新排序到发生故障转移的顺序。

最后一个命令使用新的终结点顺序更新存储在$Profile中的流量管理员配置文件。

参数

-LoadBalancingMethod

指定用于分发连接的负载均衡方法。 有效值为:

  • 性能
  • 故障转移
  • 循环
类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorPort

指定用于监视终结点运行状况的端口。 有效值为大于 0 且小于或等于 65,535 的整数值。

类型:Int32
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorProtocol

指定用于监视终结点运行状况的协议。 有效值为:

  • Http
  • Https
类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorRelativePath

指定要探测运行状况的终结点域名的相对路径。 路径必须满足以下限制:

  • 路径必须介于 1 到 1000 个字符之间。
  • 它必须以正斜杠 /.
  • 它必须不包含任何 XML 元素。 <>
  • 它必须不包含双斜杠 //。
  • 它不能包含无效的 HTML 转义字符。 例如,%XY。
类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定要更新的流量管理员配置文件的名称。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

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

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-TrafficManagerProfile

指定用于设置配置文件的流量管理员配置文件对象。

类型:IProfileWithDefinition
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-Ttl

指定 DNS 生存时间(TTL),告知本地 DNS 解析程序缓存 DNS 条目的时间。 有效值为 30 到 999,999 的整数。

类型:Int32
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

输出

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

此 cmdlet 生成流量管理员配置文件对象。