你当前正在访问 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 生成一个流量管理员配置文件对象,其中包含有关更新的配置文件的信息。