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

Set-AzureTrafficManagerProfile

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

注意

本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。 若要了解用于管理 Azure 资源管理器资源的 cmdlet,请参阅 Az PowerShell 模块

语法

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

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

  • 性能
  • 故障转移
  • RoundRobin
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorPort

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorProtocol

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

  • Http
  • Https
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorRelativePath

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

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

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TrafficManagerProfile

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

Type:IProfileWithDefinition
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Ttl

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输出

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

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