Set-AzureTrafficManagerEndpoint
更新流量管理員設定檔中端點的屬性。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet,請參閱 Az PowerShell 模組 。
Syntax
Set-AzureTrafficManagerEndpoint
-DomainName <String>
[-Location <String>]
[-Type <String>]
[-Status <String>]
[-Weight <Int32>]
[-MinChildEndpoints <Int32>]
-TrafficManagerProfile <IProfileWithDefinition>
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
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
指定要修改之端點的功能變數名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
指定 Cmdlet 新增的端點位置。 這必須是 Azure 位置。
此參數必須包含類型為 「Any」 或類型 「TrafficManager」 之端點的值,該設定檔的負載平衡方法設定為 「效能」。
可能的值為 Azure 區功能變數名稱稱,如 所列。 https://azure.microsoft.com/regions/https://azure.microsoft.com/regions/
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinChildEndpoints
指定巢狀設定檔在線上必須有的端點數目下限,此端點才能視為線上。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 |
-Status
指定監視端點的狀態。 有效值為:
- 啟用
- 已停用
如果您指定 Enabled 的值,流量管理員會監視端點,並在管理流量時考慮負載平衡方法。
Type: | String |
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 |
-Type
指定端點的類型。 有效值為:
CloudService
AzureWebsite
TrafficManager
任何
如果有多個 AzureWebsite 端點,端點必須位於不同的資料中心。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Weight
指定 Cmdlet 所新增端點的權數。 此參數的有效值範圍是 [1,1000]。
此參數僅用於 RoundRobin 負載平衡原則。
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 會產生流量管理員設定檔物件,其中包含已更新設定檔的相關資訊。