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 アプリを指します。 このコマンドでは、Web アプリ リソースによって場所が 提供されるため、EndpointLocation パラメーターは指定されません。
パラメーター
-AlwaysServe
Always Serve が有効になっている場合、エンドポイントの正常性のプローブは無効になり、エンドポイントはトラフィック ルーティング方法に含まれます。
| Type: | String |
| Accepted values: | Enabled, Disabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomHeader
プローブ要求のカスタム ヘッダー名と値のペアの一覧。
| Type: | List<T>[TrafficManagerCustomHeader] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndpointLocation
パフォーマンス トラフィック ルーティング方法で使用するエンドポイントの場所を指定します。 このパラメーターは、ExternalEndpoints 型または NestedEndpoints 型のエンドポイントにのみ適用されます。 パフォーマンス トラフィック ルーティング方法を使用する場合は、このパラメーターを指定する必要があります。
Azure リージョン名を指定します。 Azure リージョンの完全な一覧については、Azure リージョン (http://azure.microsoft.com/regions/) に関するhttp://azure.microsoft.com/regions/ページを参照してください。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndpointStatus
エンドポイントの状態を指定します。 有効な値は次の通りです。
- Enabled
- 無効
状態が [有効] の場合、エンドポイントはエンドポイントの正常性をプローブし、トラフィック ルーティング方法に含まれます。
| Type: | String |
| Accepted values: | Enabled, Disabled |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GeoMapping
"地理的" トラフィック ルーティング方法を使用する場合に、このエンドポイントにマップされるリージョンの一覧。 許容される値の完全な一覧については、Traffic Manager のドキュメントを参照してください。
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinChildEndpoints
Azure リージョン名を指定します。 Azure リージョンの完全な一覧については、Azure リージョン (http://azure.microsoft.com/regions/) に関するhttp://azure.microsoft.com/regions/ページを参照してください。
| Type: | Nullable<T>[UInt32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinChildEndpointsIPv4
親プロファイルの入れ子になったエンドポイントが使用可能と見なされるためには、子プロファイルで使用できる必要がある IPv4 (DNS レコード タイプ A) エンドポイントの最小数。 型 'NestedEndpoints' のエンドポイントにのみ適用されます。
| Type: | Nullable<T>[UInt32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinChildEndpointsIPv6
親プロファイルの入れ子になったエンドポイントが使用可能と見なされるためには、子プロファイルで使用できる必要がある IPv6 (DNS レコード タイプ AAAA) エンドポイントの最小数。 型 'NestedEndpoints' のエンドポイントにのみ適用されます。
| Type: | Nullable<T>[UInt32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
このコマンドレットで作成する Traffic Manager エンドポイントの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Priority
Traffic Manager がエンドポイントに割り当てる優先順位を指定します。 このパラメーターは、Traffic Manager プロファイルが Priority トラフィック ルーティング方法で構成されている場合にのみ使用されます。 有効な値は、1 ~ 1000 の整数です。 値が小さい方が優先度が高いことを表します。
優先度を指定する場合は、プロファイル内のすべてのエンドポイントで優先順位を指定する必要があります。同じ優先度の値を共有できるエンドポイントは 2 つありません。 優先順位を指定しない場合、Traffic Manager は、プロファイルがエンドポイントを一覧表示する順序で、1 から始まる既定の優先度の値をエンドポイントに割り当てます。
| Type: | Nullable<T>[UInt32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProfileName
このコマンドレットがエンドポイントを追加する Traffic Manager プロファイルの名前を指定します。 プロファイルを取得するには、New-AzTrafficManagerProfile コマンドレットまたは Get-AzTrafficManagerProfile コマンドレットを使用します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
リソース グループの名前を指定します。 このコマンドレットは、このパラメーターが指定するグループに Traffic Manager エンドポイントを作成します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubnetMapping
"サブネット" トラフィック ルーティング方法を使用する場合に、このエンドポイントにマップされるアドレス範囲またはサブネットの一覧。
| Type: | List<T>[TrafficManagerIpAddressRange] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Target
エンドポイントの完全修飾 DNS 名を指定します。 Traffic Manager は、トラフィックをこのエンドポイントに転送するときに、DNS 応答でこの値を返します。 このパラメーターは、ExternalEndpoints エンドポイントの種類にのみ指定します。 その他のエンドポイントの種類の場合は、代わりに TargetResourceId パラメーターを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetResourceId
ターゲットのリソース ID を指定します。 このパラメーターは、AzureEndpoints および NestedEndpoints エンドポイントの種類にのみ指定します。 ExternalEndpoints エンドポイントの種類として、代わりに Target パラメーターを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Type
このコマンドレットが Traffic Manager プロファイルに追加するエンドポイントの種類を指定します。 有効な値は次の通りです。
- AzureEndpoints
- ExternalEndpoints
- NestedEndpoints
| Type: | String |
| Accepted values: | AzureEndpoints, ExternalEndpoints, NestedEndpoints |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Weight
Traffic Manager がエンドポイントに割り当てる重みを指定します。 有効な値は、1 ~ 1000 の整数です。 既定値は 1 です。 このパラメーターは、Traffic Manager プロファイルが重み付けトラフィック ルーティング方法で構成されている場合にのみ使用されます。
| Type: | Nullable<T>[UInt32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
出力
関連リンク
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示