Add-AzureTrafficManagerEndpoint
Traffic Manager プロファイルにエンドポイントを追加します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、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>]
説明
Add-AzureTrafficManagerEndpoint コマンドレットは、Microsoft Azure Traffic Manager プロファイルにエンドポイントを追加します。 エンドポイントを追加した後、パイプライン 演算子を使用して Set-AzureTrafficManagerProfile コマンドレットに結果を渡します。 このコマンドレットは 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 コマンドレットを使用して ContosoProfile という名前のプロファイルを取得し、$TrafficManagerProfile変数に格納します。
2 番目のコマンドは、$TrafficManagerProfileに格納されている Traffic Manager プロファイルにエンドポイントを追加します。 エンドポイントにはドメイン名 Contoso02App.couldapp.net があります。 このコマンドは、有効かどうかとその種類も指定します。 このコマンドは、プロファイル オブジェクトを Set-AzureTrafficManagerProfile コマンドレットに渡して Azure に接続し、変更を保存します。
例 2: 指定した場所と重みを持つエンドポイントを追加する
PS C:\>Add-AzureTrafficManagerEndpoint -TrafficManagerProfile ContosoTrafficManagerProfile -DomainName " Contoso02App.cloudapp.net" -Status Enabled -Type CloudService -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile
このコマンドは、Traffic Manager プロファイルにエンドポイントを追加します。 エンドポイントにはドメイン名 Contoso02App.couldapp.net があります。 このコマンドは、有効かどうかとその種類も指定します。 このコマンドでは、エンドポイントの重みと場所も指定します。 このコマンドは、プロファイル オブジェクトを Set-AzureTrafficManagerProfile に渡して Azure に接続し、変更を保存します。
パラメーター
-DomainName
追加するエンドポイントのドメイン名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Location
コマンドレットによって追加されるエンドポイントの場所を指定します。 これは Azure の場所である必要があります。
このパラメーターには、負荷分散方法が "Performance" に設定されているプロファイル内の "Any" 型または種類 "TrafficManager" のエンドポイントの値を含める必要があります。 使用可能な値は、次に示すように https://azure.microsoft.com/regions/、Azure リージョン名です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MinChildEndpoints
このエンドポイントをオンラインと見なすために、入れ子になったプロファイルがオンラインにする必要があるエンドポイントの最小数を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Status
監視エンドポイントの状態を指定します。 有効な値は次の通りです。
- Enabled
- 無効
[有効] の値を指定した場合、Traffic Manager はエンドポイントを監視し、負荷分散方法はトラフィックを管理するときにそれを考慮します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TrafficManagerProfile
エンドポイントを追加する Traffic Manager プロファイル オブジェクトを指定します。
型: | IProfileWithDefinition |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Type
エンドポイントの種類を指定します。 有効な値は次の通りです。
CloudService
AzureWebsite
TrafficManager
[任意]
複数の AzureWebsite エンドポイントがある場合、エンドポイントは異なるデータセンターに存在する必要があります。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Weight
コマンドレットによって追加されるエンドポイントの重みを指定します。 このパラメーターの有効な値の範囲は [1,1000] です。
このパラメーターは、RoundRobin 負荷分散ポリシーにのみ使用されます。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
このコマンドレットは、更新されたプロファイルに関する情報を含む Traffic Manager プロファイル オブジェクトを生成します。