次の方法で共有

Add-AzTrafficManagerEndpointConfig

  • リファレンス
モジュール:
Az.TrafficManager

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

構文

Add-AzTrafficManagerEndpointConfig
   -EndpointName <String>
   -TrafficManagerProfile <TrafficManagerProfile>
   -Type <String>
   [-TargetResourceId <String>]
   [-Target <String>]
   -EndpointStatus <String>
   [-Weight <UInt32>]
   [-Priority <UInt32>]
   [-EndpointLocation <String>]
   [-AlwaysServe <String>]
   [-MinChildEndpoints <UInt32>]
   [-MinChildEndpointsIPv4 <UInt32>]
   [-MinChildEndpointsIPv6 <UInt32>]
   [-GeoMapping <System.Collections.Generic.List`1[System.String]>]
   [-SubnetMapping <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerIpAddressRange]>]
   [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Add-AzTrafficManagerEndpointConfig コマンドレットは、ローカルの Azure Traffic Manager プロファイル オブジェクトにエンドポイントを追加します。 プロファイルを取得するには、New-AzTrafficManagerProfile コマンドレットまたは Get-AzTrafficManagerProfile コマンドレットを使用します。

このコマンドレットは、ローカル プロファイル オブジェクトに対して動作します。 Set-AzTrafficManagerProfile コマンドレットを使用して、Traffic Manager のプロファイルに対する変更をコミットします。 エンドポイントを作成し、1 回の操作で変更をコミットするには、New-AzTrafficManagerEndpoint コマンドレットを使用します。

例

例 1: プロファイルにエンドポイントを追加する

$TrafficManagerProfile = Get-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
Add-AzTrafficManagerEndpointConfig -EndpointName "contoso" -EndpointStatus Enabled -Target "www.contoso.com" -TrafficManagerProfile $TrafficManagerProfile -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Weight 10
Set-AzTrafficManagerProfile -TrafficManagerProfile $TrafficManagerProfile

最初のコマンドは、 Get-AzTrafficManagerProfile コマンドレットを使用して Azure Traffic Manager プロファイルを取得します。 このコマンドは、ローカル プロファイルを $TrafficManagerProfile 変数に格納します。

2 番目のコマンドは、$TrafficManagerProfileに格納されているプロファイルに contoso という名前のエンドポイントを追加します。 このコマンドには、エンドポイントの構成データが含まれています。 このコマンドは、ローカル オブジェクトのみを変更します。

最後のコマンドは、Azure の Traffic Manager プロファイルを更新して、$TrafficManagerProfileのローカル値と一致させます。

パラメーター

-AlwaysServe

Always Serve が有効になっている場合、エンドポイントの正常性のプローブは無効になり、エンドポイントはトラフィック ルーティング方法に含まれます。

型:String
指定可能な値:Enabled, Disabled
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CustomHeader

プローブ要求のカスタム ヘッダー名と値のペアの一覧。

型:List<T>[TrafficManagerCustomHeader]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EndpointLocation

パフォーマンス トラフィック ルーティング方法で使用するエンドポイントの場所を指定します。 このパラメーターは、ExternalEndpoints 型または NestedEndpoints 型のエンドポイントにのみ適用されます。 パフォーマンス トラフィック ルーティング方法を使用する場合は、このパラメーターを指定する必要があります。

Azure リージョン名を指定します。 Azure リージョンの完全な一覧については、「Azure リージョンhttp://azure.microsoft.com/regions/ (http://azure.microsoft.com/regions/)」を参照してください。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EndpointName

このコマンドレットが追加する Traffic Manager エンドポイントの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EndpointStatus

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

  • Enabled
  • 無効

状態が [有効] の場合、エンドポイントはエンドポイントの正常性をプローブし、トラフィック ルーティング方法に含まれます。

型:String
指定可能な値:Enabled, Disabled
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-GeoMapping

"地理的" トラフィック ルーティング方法を使用する場合に、このエンドポイントにマップされるリージョンの一覧。 許容される値の一覧については、Traffic Manager のドキュメント 参照してください。

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MinChildEndpoints

親プロファイルの入れ子になったエンドポイントが使用可能と見なされるためには、子プロファイルで使用できる必要があるエンドポイントの最小数。 型 'NestedEndpoints' のエンドポイントにのみ適用されます。

型:Nullable<T>[UInt32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MinChildEndpointsIPv4

親プロファイルの入れ子になったエンドポイントが使用可能と見なされるためには、子プロファイルで使用できる必要がある IPv4 (DNS レコード タイプ A) エンドポイントの最小数。 型 'NestedEndpoints' のエンドポイントにのみ適用されます。

型:Nullable<T>[UInt32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MinChildEndpointsIPv6

親プロファイルの入れ子になったエンドポイントが使用可能と見なされるためには、子プロファイルで使用できる必要がある IPv6 (DNS レコード タイプ AAAA) エンドポイントの最小数。 型 'NestedEndpoints' のエンドポイントにのみ適用されます。

型:Nullable<T>[UInt32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Priority

Traffic Manager がエンドポイントに割り当てる優先順位を指定します。 このパラメーターは、Traffic Manager プロファイルが Priority トラフィック ルーティング方法で構成されている場合にのみ使用されます。 有効な値は、1 ~ 1000 の整数です。 値が小さい方が優先度が高いことを表します。

優先度を指定する場合は、プロファイル内のすべてのエンドポイントで優先順位を指定する必要があります。同じ優先度の値を共有できるエンドポイントは 2 つありません。 優先順位を指定しない場合、Traffic Manager は、プロファイルがエンドポイントを一覧表示する順序で、1 から始まる既定の優先度の値をエンドポイントに割り当てます。

型:Nullable<T>[UInt32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SubnetMapping

"サブネット" トラフィック ルーティング方法を使用する場合に、このエンドポイントにマップされるアドレス範囲またはサブネットの一覧。

型:List<T>[TrafficManagerIpAddressRange]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Target

エンドポイントの完全修飾 DNS 名を指定します。 Traffic Manager は、トラフィックをこのエンドポイントに転送するときに、DNS 応答でこの値を返します。 このパラメーターは、ExternalEndpoints エンドポイントの種類にのみ指定します。 その他のエンドポイントの種類の場合は、代わりに TargetResourceId パラメーターを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TargetResourceId

ターゲットのリソース ID を指定します。 このパラメーターは、AzureEndpoints および NestedEndpoints エンドポイントの種類にのみ指定します。 ExternalEndpoints エンドポイントの種類として、代わりに Target パラメーターを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TrafficManagerProfile

ローカル TrafficManagerProfile オブジェクトを指定します。 このコマンドレットは、このローカル オブジェクトを変更します。 TrafficManagerProfile オブジェクトを取得するには、Get-AzTrafficManagerProfile コマンドレットを使用します。

型:TrafficManagerProfile
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Type

このコマンドレットが Azure Traffic Manager プロファイルに追加するエンドポイントの種類を指定します。 有効な値は次の通りです。

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints
型:String
指定可能な値:AzureEndpoints, ExternalEndpoints, NestedEndpoints
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Weight

Traffic Manager がエンドポイントに割り当てる重みを指定します。 有効な値は、1 ~ 1000 の整数です。 既定値は 1 です。 このパラメーターは、Traffic Manager プロファイルが重み付けトラフィック ルーティング方法で構成されている場合にのみ使用されます。

型:Nullable<T>[UInt32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

TrafficManagerProfile

出力

TrafficManagerProfile