次の方法で共有


New-AzTrafficManagerProfile

Traffic Manager プロファイルを作成します。

構文

Default (既定)

New-AzTrafficManagerProfile
    -Name <String>
    -ResourceGroupName <String>
    [-ProfileStatus <String>]
    -RelativeDnsName <String>
    -Ttl <UInt32>
    -TrafficRoutingMethod <String>
    -MonitorProtocol <String>
    -MonitorPort <UInt32>
    [-MonitorPath <String>]
    [-MonitorIntervalInSeconds <Int32>]
    [-MonitorTimeoutInSeconds <Int32>]
    [-MonitorToleratedNumberOfFailures <Int32>]
    [-MaxReturn <Int64>]
    [-Tag <Hashtable>]
    [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
    [-ExpectedStatusCodeRange <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerExpectedStatusCodeRange]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

説明

New-AzTrafficManagerProfile コマンドレットは、Azure Traffic Manager プロファイルを作成します。 Name パラメーターと必要な設定を指定します。 このコマンドレットは、新しいプロファイルを表すローカル オブジェクトを返します。

このコマンドレットでは、Traffic Manager エンドポイントは構成されません。 Add-AzTrafficManagerEndpointConfig コマンドレットを使用して、ローカル プロファイル オブジェクトを更新できます。 次に、Set-AzTrafficManagerProfile コマンドレットを使用して Traffic Manager に変更をアップロードします。 または、New-AzTrafficManagerEndpoint コマンドレットを使用してエンドポイントを追加することもできます。

例 1: プロファイルを作成する

New-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11" -ProfileStatus Enabled -TrafficRoutingMethod Performance -RelativeDnsName "contosoapp" -TTL 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/default.aspx"

このコマンドは、リソース グループ ResourceGroup11 に ContosoProfile という名前の Azure Traffic Manager プロファイルを作成します。 DNS FQDN が contosoapp.trafficmanager.net。

パラメーター

-CustomHeader

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

パラメーターのプロパティ

型:

List<T>[TrafficManagerCustomHeader]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

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

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExpectedStatusCodeRange

プローブ要求に必要な HTTP 状態コード範囲の一覧。

パラメーターのプロパティ

型:

List<T>[TrafficManagerExpectedStatusCodeRange]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MaxReturn

MultiValue ルーティング方法を使用してプロファイルに返される回答の最大数。

パラメーターのプロパティ

型:

Nullable<T>[Int64]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MonitorIntervalInSeconds

Traffic Manager がこのプロファイル内の各エンドポイントの正常性を確認する間隔 (秒単位)。 既定値は 30 です。

パラメーターのプロパティ

型:

Nullable<T>[Int32]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:IntervalInSecondsForMonitor

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MonitorPath

エンドポイントの正常性を監視するために使用するパスを指定します。 エンドポイント ドメイン名を基準とした値を指定します。 この値はスラッシュ (/) で始まる必要があります。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:PathForMonitor

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MonitorPort

エンドポイントの正常性を監視するために使用する TCP ポートを指定します。 有効な値は、1 から 65535 までの整数です。

パラメーターのプロパティ

型:UInt32
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:PortForMonitor

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MonitorProtocol

エンドポイントの正常性の監視に使用するプロトコルを指定します。 有効な値は次のとおりです。

  • HTTP
  • HTTPS

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:HTTP, HTTPS, TCP
ワイルドカードのサポート:False
DontShow:False
Aliases:ProtocolForMonitor

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MonitorTimeoutInSeconds

Traffic Manager で、このプロファイル内のエンドポイントが正常性チェックに応答できるようにする時間 (秒単位)。 既定値は 10 です。

パラメーターのプロパティ

型:

Nullable<T>[Int32]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:TimeoutInSecondsForMonitor

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MonitorToleratedNumberOfFailures

このプロファイルでエンドポイントを宣言する前に Traffic Manager が許容する連続した失敗した正常性チェックの数は、次に失敗した正常性チェックの後に低下します。 デフォルトは3です。

パラメーターのプロパティ

型:

Nullable<T>[Int32]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ToleratedNumberOfFailuresForMonitor

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

このコマンドレットで作成する Traffic Manager プロファイルの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ProfileStatus

プロファイルの状態を指定します。 有効な値は、有効と無効です。

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:Enabled, Disabled
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RelativeDnsName

この Traffic Manager プロファイルが提供する相対 DNS 名を指定します。 Traffic Manager は、この値と、Azure Traffic Manager がプロファイルの完全修飾ドメイン名 (FQDN) を形成するために使用する DNS ドメイン名を組み合わせます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResourceGroupName

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Tag

サーバー上のタグとして設定されたハッシュ テーブルの形式のキーと値のペア。 例えば次が挙げられます。

@{key0="value0";key1=$null;key2="value2"}

パラメーターのプロパティ

型:Hashtable
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:タグ

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TrafficRoutingMethod

トラフィック ルーティング方法を指定します。 このメソッドは、Traffic Manager が受信 DNS クエリに応答して返すエンドポイントを決定します。 有効な値は次のとおりです。

  • Performance
  • 重み付け
  • Priority
  • 地域

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:Performance, Weighted, Priority, Geographic, Subnet, MultiValue
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Ttl

DNS Time to Live (TTL) 値を指定します。

パラメーターのプロパティ

型:UInt32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

None

出力

TrafficManagerProfile