Add-AzureTrafficManagerEndpoint
將端點新增至 流量管理員 配置檔。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。
語法
Add-AzureTrafficManagerEndpoint
-DomainName <String>
[-Location <String>]
-Type <String>
-Status <String>
[-Weight <Int32>]
[-MinChildEndpoints <Int32>]
-TrafficManagerProfile <IProfileWithDefinition>
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
Add-AzureTrafficManagerEndpoint Cmdlet 會將端點新增至 Microsoft Azure 流量管理員 配置檔。 新增端點之後,請使用管線運算符,將結果傳遞至 Set-AzureTrafficManagerProfile Cmdlet。 該 Cmdlet 會連線到 Azure 以儲存變更。
範例
範例 1:將端點新增至配置檔
PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Add-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "Contoso02App.cloudapp.net" -Status "Enabled" -Type "CloudService" | Set-AzureTrafficManagerProfile
第一個命令會使用 Get-AzureTrafficManagerProfile Cmdlet 來取得名為 ContosoProfile 的配置檔,然後將它儲存在$TrafficManagerProfile變數中。
第二個命令會將端點新增至儲存在 $TrafficManagerProfile 中的 流量管理員 配置檔。 端點具有域名 Contoso02App.couldapp.net。 此命令也會指定它是否已啟用及其類型。 此命令會將配置檔對象傳遞至 Set-AzureTrafficManagerProfile Cmdlet,以連線到 Azure 以儲存變更。
範例 2:新增具有指定位置和權數的端點
PS C:\>Add-AzureTrafficManagerEndpoint -TrafficManagerProfile ContosoTrafficManagerProfile -DomainName " Contoso02App.cloudapp.net" -Status Enabled -Type CloudService -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile
此命令會將端點新增至 流量管理員 配置檔。 端點具有域名 Contoso02App.couldapp.net。 此命令也會指定它是否已啟用及其類型。 此命令也會指定端點的權數和位置。 此命令會將配置檔對象傳遞至 Set-AzureTrafficManagerProfile ,以連線到 Azure 以儲存變更。
參數
-DomainName
指定要新增之端點的功能變數名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Location
指定 Cmdlet 新增的端點位置。 這必須是 Azure 位置。
此參數必須包含類型為 「Any」 或類型 「TrafficManager」 之端點的值,該配置檔的負載平衡方法設定為 「效能」。 可能的值為 Azure 區域名稱,如 所列。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
指定監視端點的狀態。 有效值為:
- 啟用
- 停用
如果您指定 Enabled 的值,流量管理員 監視端點,並在管理流量時考慮負載平衡方法。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-TrafficManagerProfile
指定要新增端點的配置檔物件 流量管理員。
類型: | IProfileWithDefinition |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Type
指定端點的類型。 有效值為:
CloudService
AzureWebsite
TrafficManager
任意
如果有多個 AzureWebsite 端點,端點必須位於不同的數據中心。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Weight
指定 Cmdlet 所新增端點的權數。 此參數的有效值範圍是 [1,1000]。
此參數僅用於 RoundRobin 負載平衡原則。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸出
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
此 Cmdlet 會產生 流量管理員 配置檔物件,其中包含更新配置檔的相關信息。