Share via

Add-AzureTrafficManagerEndpoint

  • リファレンス
モジュール:
Azure

Traffic Manager プロファイルにエンドポイントを追加します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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

追加するエンドポイントのドメイン名を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

コマンドレットによって追加されるエンドポイントの場所を指定します。 これは Azure の場所である必要があります。

このパラメーターには、負荷分散方法が "Performance" に設定されているプロファイル内の "Any" 型または種類 "TrafficManager" のエンドポイントの値を含める必要があります。 使用可能な値は、次に示すように https://azure.microsoft.com/regions/、Azure リージョン名です。

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

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Status

監視エンドポイントの状態を指定します。 有効な値は次のとおりです。

  • Enabled
  • 無効

[有効] の値を指定した場合、Traffic Manager はエンドポイントを監視し、負荷分散方法はトラフィックを管理するときにそれを考慮します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TrafficManagerProfile

エンドポイントを追加する Traffic Manager プロファイル オブジェクトを指定します。

Type:IProfileWithDefinition
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Type

エンドポイントの種類を指定します。 有効な値は次のとおりです。

  • CloudService

  • AzureWebsite

  • TrafficManager

  • Any

複数の AzureWebsite エンドポイントがある場合、エンドポイントは異なるデータセンターに存在する必要があります。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Weight

コマンドレットによって追加されるエンドポイントの重みを指定します。 このパラメーターの有効な値の範囲は [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

このコマンドレットは、更新されたプロファイルに関する情報を含む Traffic Manager プロファイル オブジェクトを生成します。