New-AzureTrafficManagerProfile
Traffic Manager プロファイルを作成します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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 のサブドメインである必要があります。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LoadBalancingMethod
接続の分散に使用する負荷分散方法を指定します。 有効な値は次のとおりです。
- パフォーマンス
- フェールオーバー
- RoundRobin
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MonitorPort
エンドポイントの正常性を監視するために使用するポートを指定します。 有効な値は、0 より大きく、65,535 以下の整数値です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MonitorProtocol
エンドポイントの正常性の監視に使用するプロトコルを指定します。 有効な値は次のとおりです。
Http
Https
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MonitorRelativePath
正常性状態をプローブするエンドポイント ドメイン名に対する相対パスを指定します。 パスは次の制限を満たしている必要があります。
パスは 1 ~ 1000 文字にする必要があります。
スラッシュ /で始まる必要があります。
XML 要素 <>を含めてはなりません。
二重スラッシュ // を含めてはなりません。
無効な HTML エスケープ文字を含めてはなりません。 たとえば、%XY です。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
作成する Traffic Manager プロファイルの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Ttl
DNS エントリをキャッシュする時間をローカル DNS リゾルバーに通知する DNS Time-to-Live (TTL) を指定します。 有効な値は、30 ~ 999,999 の整数です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
出力
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
このコマンドレットは、Traffic Manager プロファイル オブジェクトを生成します。