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