次の方法で共有


New-AzTrafficManagerEndpoint

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

構文

New-AzTrafficManagerEndpoint
   -Name <String>
   -ProfileName <String>
   -ResourceGroupName <String>
   -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>]

説明

New-AzTrafficManagerEndpoint コマンドレットは、Azure Traffic Manager プロファイルにエンドポイントを作成します。

このコマンドレットは、新しい各エンドポイントを Traffic Manager サービスにコミットします。 複数のエンドポイントをローカル Traffic Manager プロファイル オブジェクトに追加し、1 回の操作で変更をコミットするには、Add-AzTrafficManagerEndpointConfig コマンドレットを使用します。

例 1: プロファイルの外部エンドポイントを作成する

New-AzTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Target "www.contoso.com" -Weight 10

このコマンドは、ResourceGroup11 という名前のリソース グループ内の ContosoProfile という名前のプロファイルに contoso という名前の外部エンドポイントを作成します。

例 2: プロファイルの Azure エンドポイントを作成する

New-AzTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type AzureEndpoints -Priority 1 -TargetResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Default-Web-CentralUS/providers/Microsoft.Web/sites/contoso-web-app" -Weight 10

このコマンドは、リソース グループ ResourceGroup11 の ContosoProfile という名前のプロファイルに contoso という名前の Azure エンドポイントを作成します。 Azure エンドポイントは、Azure Resource Manager ID が TargetResourceId の URI パスによって指定された Azure Web アプリを指します。 このコマンドでは、 EndpointLocation パラメーターは指定されません。これは、Web アプリ リソースによって場所が提供されるためです。

パラメーター

-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

-EndpointStatus

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

  • Enabled
  • 無効

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

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

-GeoMapping

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

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

-MinChildEndpoints

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

型: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

-Name

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

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

-Priority

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

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

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

-ProfileName

このコマンドレットがエンドポイントを追加する Traffic Manager プロファイルの名前を指定します。 プロファイルを取得するには、New-AzTrafficManagerProfile コマンドレットまたは Get-AzTrafficManagerProfile コマンドレットを使用します。

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

-ResourceGroupName

リソース グループの名前を指定します。 このコマンドレットは、このパラメーターが指定するグループに Traffic Manager エンドポイントを作成します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る: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

-Type

このコマンドレットが 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

入力

None

出力

TrafficManagerEndpoint