Add-AzureTrafficManagerEndpoint
將端點新增至流量管理員設定檔。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet,請參閱 Az PowerShell 模組 。
Syntax
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
指定要新增之端點的功能變數名稱。
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/
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: | True |
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: | True |
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 會產生流量管理員設定檔物件,其中包含已更新設定檔的相關資訊。