New-AzureTrafficManagerProfile
Traffic Manager プロファイルを作成します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
New-AzureTrafficManagerProfile
-Name <String>
-DomainName <String>
-LoadBalancingMethod <String>
-MonitorPort <Int32>
-MonitorProtocol <String>
-MonitorRelativePath <String>
-Ttl <Int32>
[-Profile <AzureSMProfile>]
[<CommonParameters>]
説明
New-AzureTrafficManagerProfile コマンドレットは、Microsoft Azure Traffic Manager プロファイルを作成します。
LoadBalancingMethod 値を "Failover" に設定するプロファイルを作成した後、Add-AzureTrafficManagerEndpoint コマンドレットを使用して、プロファイルに追加するエンドポイントのフェールオーバー順序を決定できます。 詳細については、以下の例 2 を参照してください。
例
例 1: Traffic Manager プロファイルを作成する
PS C:\>New-AzureTrafficManagerProfile -Name "MyProfile" -DomainName "My.profile.trafficmanager.net" -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"
このコマンドは、ラウンド ロビン負荷分散方法、TTL 30 秒、HTTP 監視プロトコル、監視ポート 80、および指定したパスを使用して、指定された Traffic Manager ドメインに MyProfile という名前の Traffic Manager プロファイルを作成します。
例 2: エンドポイントを目的のフェールオーバー順序に並べ替える
PS C:\>$Profile = Get-AzureTrafficManagerProfile -Name "MyProfile"
PS C:\> $Profile.Endpoints[0],$Profile.Endpoints[1] = $Profile.Endpoints[1],$Profile.Endpoints[0]
PS C:\> $Profile = Set-AzureTrafficManagerProfile
この例では、MyProfile に追加されたエンドポイントを目的のフェールオーバー順序に並べ替えます。
最初のコマンドは、MyProfile という名前の Traffic Manager プロファイル オブジェクトを取得し、そのオブジェクトを $Profile 変数に格納します。
2 番目のコマンドは、エンドポイント配列からフェールオーバーが発生する順序にエンドポイントを並べ替えます。
最後のコマンドは、$Profileに格納されている Traffic Manager プロファイルを新しいエンドポイントの順序で更新します。
パラメーター
-DomainName
Traffic Manager プロファイルのドメイン名を指定します。 これは、trafficmanager.net のサブドメインである必要があります。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-LoadBalancingMethod
接続の分散に使用する負荷分散方法を指定します。 有効な値は次のとおりです。
- パフォーマンス
- [フェールオーバー]
- RoundRobin
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MonitorPort
エンドポイントの正常性を監視するために使用するポートを指定します。 有効な値は、0 より大きく、65,535 以下の整数値です。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MonitorProtocol
エンドポイントの正常性の監視に使用するプロトコルを指定します。 有効な値は次のとおりです。
Http
Https
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MonitorRelativePath
正常性状態をプローブするエンドポイント ドメイン名に対する相対パスを指定します。 パスは次の制限を満たしている必要があります。
パスは 1 ~ 1000 文字にする必要があります。
スラッシュ /で始まる必要があります。
XML 要素 <>を含めてはなりません。
二重スラッシュ // を含めてはなりません。
無効な HTML エスケープ文字を含めてはなりません。 たとえば、%XY です。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
作成する Traffic Manager プロファイルの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Ttl
DNS エントリをキャッシュする時間をローカル DNS リゾルバーに通知する DNS Time-to-Live (TTL) を指定します。 有効な値は、30 ~ 999,999 の整数です。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
このコマンドレットは、Traffic Manager プロファイル オブジェクトを生成します。