Add-AzTrafficManagerEndpointConfig
ローカル 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 が有効になっている場合、エンドポイントの正常性のプローブは無効になり、エンドポイントはトラフィック ルーティング方法に含まれます。
| 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 |
-EndpointName
このコマンドレットが追加する Traffic Manager エンドポイントの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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
親プロファイルの入れ子になったエンドポイントが使用可能と見なされるためには、子プロファイルで使用できる必要があるエンドポイントの最小数。 型 'NestedEndpoints' のエンドポイントにのみ適用されます。
| 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 |
-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 |
-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 |
-TrafficManagerProfile
ローカル TrafficManagerProfile オブジェクトを指定します。 このコマンドレットは、このローカル オブジェクトを変更します。 TrafficManagerProfile オブジェクトを取得するには、Get-AzTrafficManagerProfile コマンドレットを使用します。
| Type: | TrafficManagerProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Type
このコマンドレットが Azure 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 |