你当前正在访问 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 的 Azure 资源管理器 (ARM) 资源的 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
指定用于分发连接的负载均衡方法。 有效值为:
- 性能
- 故障转移
- 循环
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-MonitorPort
指定用于监视终结点运行状况的端口。 有效值为大于 0 且小于或等于 65,535 的整数值。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-MonitorProtocol
指定用于监视终结点运行状况的协议。 有效值为:
- Http
- Https
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-MonitorRelativePath
指定要探测运行状况的终结点域名的相对路径。 路径必须满足以下限制:
- 路径必须介于 1 到 1000 个字符之间。
- 它必须以正斜杠 /.
- 它必须不包含任何 XML 元素。 <>
- 它必须不包含双斜杠 //。
- 它不能包含无效的 HTML 转义字符。 例如,%XY。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Name
指定要更新的流量管理员配置文件的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。
类型: | AzureSMProfile |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TrafficManagerProfile
指定用于设置配置文件的流量管理员配置文件对象。
类型: | IProfileWithDefinition |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Ttl
指定 DNS 生存时间(TTL),告知本地 DNS 解析程序缓存 DNS 条目的时间。 有效值为 30 到 999,999 的整数。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输出
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
此 cmdlet 生成流量管理员配置文件对象。