PowerShell を使用した Traffic Manager の管理Using PowerShell to manage Traffic Manager

Azure Resource Manager は、Azure のサービスの優先管理インターフェイスです。Azure Resource Manager is the preferred management interface for services in Azure. Azure Traffic Manager ベースの API とツールを使用して、Azure Traffic Manager プロファイルを管理できます。Azure Traffic Manager profiles can be managed using Azure Resource Manager-based APIs and tools.

注意

この記事は、新しい Azure PowerShell Az モジュールを使用するために更新されました。This article has been updated to use the new Azure PowerShell Az module. AzureRM モジュールはまだ使用でき、少なくとも 2020 年 12 月までは引き続きバグ修正が行われます。You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Az モジュールと AzureRM の互換性の詳細については、「Introducing the new Azure PowerShell Az module (新しい Azure PowerShell Az モジュールの概要)」を参照してください。To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Az モジュールのインストール手順については、Azure PowerShell のインストールを参照してください。For Az module installation instructions, see Install Azure PowerShell.

リソース モデルResource model

Azure Traffic Manager は、Traffic Manager プロファイルと呼ばれる設定のコレクションを使用して構成されます。Azure Traffic Manager is configured using a collection of settings called a Traffic Manager profile. このプロファイルには、DNS 設定、トラフィック ルーティング設定、エンドポイント監視設定、トラフィックのルーティング先となるサービス エンドポイントのリストが含まれます。This profile contains DNS settings, traffic routing settings, endpoint monitoring settings, and a list of service endpoints to which traffic is routed.

各 Traffic Manager プロファイルは、'TrafficManagerProfiles' 型のリソースで表されます。Each Traffic Manager profile is represented by a resource of type 'TrafficManagerProfiles'. REST API レベルでの各プロファイルの URI は次のとおりです。At the REST API level, the URI for each profile is as follows:

https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Network/trafficManagerProfiles/{profile-name}?api-version={api-version}

Azure PowerShell の設定Setting up Azure PowerShell

注意

この記事は、新しい Azure PowerShell Az モジュールを使用するために更新されました。This article has been updated to use the new Azure PowerShell Az module. AzureRM モジュールはまだ使用でき、少なくとも 2020 年 12 月までは引き続きバグ修正が行われます。You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Az モジュールと AzureRM の互換性の詳細については、「Introducing the new Azure PowerShell Az module (新しい Azure PowerShell Az モジュールの概要)」を参照してください。To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Az モジュールのインストール手順については、Azure PowerShell のインストールを参照してください。For Az module installation instructions, see Install Azure PowerShell.

以下の手順では、Microsoft Azure PowerShell を使用します。These instructions use Microsoft Azure PowerShell. 次の記事では、Azure PowerShell をインストールして構成する方法について説明します。The following article explains how to install and configure Azure PowerShell.

この記事の例では、既存のリソース グループがあることを前提としています。The examples in this article assume that you have an existing resource group. リソース グループを作成するには、次のコマンドを使用します。You can create a resource group using the following command:

New-AzResourceGroup -Name MyRG -Location "West US"

注意

Azure Resource Manager では、すべてのリソース グループの場所を指定する必要があります。Azure Resource Manager requires that all resource groups have a location. この場所は、そのリソース グループで作成するリソースの既定の保存先として使用されます。This location is used as the default for resources created in that resource group. ただし、Traffic Manager プロファイル リソースはグローバルであり、リージョンの違いがないため、リソース グループの場所を選択しても、Azure Traffic Manager には影響しません。However, since Traffic Manager profile resources are global, not regional, the choice of resource group location has no impact on Azure Traffic Manager.

Traffic Manager プロファイルの作成Create a Traffic Manager Profile

Traffic Manager プロファイルを作成するには、New-AzTrafficManagerProfile コマンドレットを使用します。To create a Traffic Manager profile, use the New-AzTrafficManagerProfile cmdlet:

$TmProfile = New-AzTrafficManagerProfile -Name MyProfile -ResourceGroupName MyRG -TrafficRoutingMethod Performance -RelativeDnsName contoso -Ttl 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/"

次の表で、パラメーターについて説明します。The following table describes the parameters:

パラメーターParameter 説明Description
NameName Traffic Manager プロファイル リソースのリソース名。The resource name for the Traffic Manager profile resource. 同じリソース グループ内のプロファイルには、一意の名前が必要です。Profiles in the same resource group must have unique names. この名前は、DNS クエリに使用される DNS 名とは別のものです。This name is separate from the DNS name used for DNS queries.
ResourceGroupNameResourceGroupName プロファイル リソースを含むリソース グループの名前。The name of the resource group containing the profile resource.
TrafficRoutingMethodTrafficRoutingMethod DNS クエリへの応答で返されるエンドポイントを特定するために使用する、トラフィック ルーティング方法を指定します。Specifies the traffic-routing method used to determine which endpoint is returned in response a DNS query. 指定できる値は、'Performance'、'Weighted' または 'Priority' です。Possible values are 'Performance', 'Weighted' or 'Priority'.
RelativeDnsNameRelativeDnsName この Traffic Manager プロファイルで提供される DNS 名のホスト名の部分を指定します。Specifies the hostname portion of the DNS name provided by this Traffic Manager profile. Azure Traffic Manager が使用する DNS ドメイン名とこの値を組み合わせて、プロファイルの完全修飾ドメイン名 (FQDN) が形成されます。This value is combined with the DNS domain name used by Azure Traffic Manager to form the fully qualified domain name (FQDN) of the profile. たとえば、'contoso' と値を設定すると 'contoso.trafficmanager.net' になります。For example, setting the value of 'contoso' becomes 'contoso.trafficmanager.net.'
TTLTTL DNS の TTL (Time-to-Live) を秒単位で指定します。Specifies the DNS Time-to-Live (TTL), in seconds. この TTL は、ローカル DNS リゾルバーと DNS クライアントに、この Traffic Manager プロファイルでの DNS 応答をキャッシュする時間の長さを通知します。This TTL informs the Local DNS resolvers and DNS clients how long to cache DNS responses for this Traffic Manager profile.
MonitorProtocolMonitorProtocol エンドポイントの正常性の監視に使用するプロトコルを指定します。Specifies the protocol to use to monitor endpoint health. 指定できる値は、'HTTP' と 'HTTPS' です。Possible values are 'HTTP' and 'HTTPS'.
MonitorPortMonitorPort エンドポイントの正常性の監視に使用する TCP ポートを指定します。Specifies the TCP port used to monitor endpoint health.
MonitorPathMonitorPath エンドポイントの正常性のプローブに使用する、エンドポイントのドメイン名の相対パスを指定します。Specifies the path relative to the endpoint domain name used to probe for endpoint health.

このコマンドレットは、Azure 内に Traffic Manager プロファイルを作成し、対応するプロファイル オブジェクトを PowerShell に返します。The cmdlet creates a Traffic Manager profile in Azure and returns a corresponding profile object to PowerShell. この時点では、プロファイルにはエンドポイントがありません。At this point, the profile does not contain any endpoints. Traffic Manager プロファイルにエンドポイントを追加する方法の詳細については、Traffic Manager エンドポイントの追加に関するセクションを参照してください。For more information about adding endpoints to a Traffic Manager profile, see Adding Traffic Manager Endpoints.

Traffic Manager プロファイルの取得Get a Traffic Manager Profile

既存の Traffic Manager プロファイル オブジェクトを取得するには、Get-AzTrafficManagerProfle コマンドレットを使用します。To retrieve an existing Traffic Manager profile object, use the Get-AzTrafficManagerProfle cmdlet:

$TmProfile = Get-AzTrafficManagerProfile -Name MyProfile -ResourceGroupName MyRG

このコマンドレットは、Traffic Manager プロファイル オブジェクトを返します。This cmdlet returns a Traffic Manager profile object.

Traffic Manager プロファイルの更新Update a Traffic Manager Profile

Traffic Manager プロファイルの変更は、次の 3 段階の手順で行います。Modifying Traffic Manager profiles follows a 3-step process:

  1. Get-AzTrafficManagerProfile を使用してプロファイルを取得する、または New-AzTrafficManagerProfile が返すプロファイルを使用します。Retrieve the profile using Get-AzTrafficManagerProfile or use the profile returned by New-AzTrafficManagerProfile.
  2. プロファイルを変更します。Modify the profile. エンドポイントを追加、削除したり、エンドポイントやプロファイルのパラメーターを変更できます。You can add and remove endpoints or change endpoint or profile parameters. これらの変更はオフラインで行う操作です。These changes are off-line operations. プロファイルを表すメモリ内のローカル オブジェクトのみが変更されます。You are only changing the local object in memory that represents the profile.
  3. Set-AzTrafficManagerProfile コマンドレットを使用して変更をコミットします。Commit your changes using the Set-AzTrafficManagerProfile cmdlet.

プロファイルの RelativeDnsName を除くすべてのプロファイル プロパティを変更できます。All profile properties can be changed except the profile's RelativeDnsName. RelativeDnsName を変更するには、プロファイルを削除し、新しい名前で新しいプロファイルを作成する必要があります。To change the RelativeDnsName, you must delete profile and a new profile with a new name.

次の例では、プロファイルの TTL を変更する方法を示します。The following example demonstrates how to change the profile's TTL:

$TmProfile = Get-AzTrafficManagerProfile -Name MyProfile -ResourceGroupName MyRG
$TmProfile.Ttl = 300
Set-AzTrafficManagerProfile -TrafficManagerProfile $TmProfile

Traffic Manager エンドポイントには、次の 3 種類があります。There are three types of Traffic Manager endpoints:

  1. Azure エンドポイント : Azure でホストされるサービスです。Azure endpoints are services hosted in Azure
  2. 外部エンドポイント: Azure の外部でホストされるサービスです。External endpoints are services hosted outside of Azure
  3. 入れ子になったエンドポイント: Traffic Manager プロファイルの入れ子構造の階層を構築するために使用します。Nested endpoints are used to construct nested hierarchies of Traffic Manager profiles. 入れ子になったエンドポイントを使用すると、複雑なアプリケーションの高度なトラフィック ルーティングの構成を行うことができます。Nested endpoints enable advanced traffic-routing configurations for complex applications.

これら 3 つのすべてのケースで、エンドポイントの追加方法が 2 つあります。In all three cases, endpoints can be added in two ways:

  1. 前述の 3 段階の手順を使用します。Using a 3-step process described previously. この方法の利点は、1 回の更新でエンドポイントの変更を複数行うことができる点です。The advantage of this method is that several endpoint changes can be made in a single update.
  2. New-AzTrafficManagerEndpoint コマンドレットを使用します。Using the New-AzTrafficManagerEndpoint cmdlet. この cmdlet により、1 回の操作で既存の Traffic Manager プロファイルにエンドポイントが追加されます。This cmdlet adds an endpoint to an existing Traffic Manager profile in a single operation.

Azure エンドポイントの追加Adding Azure Endpoints

Azure エンドポイントは、Azure でホストされるサービスを参照します。Azure endpoints reference services hosted in Azure. 2 種類の Azure エンドポイントがサポートされています。Two types of Azure endpoints are supported:

  1. Azure App ServiceAzure App Service
  2. Azure PublicIpAddress リソース (ロード バランサーまたは仮想マシン NIC に接続できます)。Azure PublicIpAddress resources (which can be attached to a load-balancer or a virtual machine NIC). PublicIpAddress には、Traffic Manager で使用するために DNS 名を割り当てておく必要があることに注意してください。The PublicIpAddress must have a DNS name assigned to be used in Traffic Manager.

いずれの場合も、次のことが当てはまります。In each case:

  • サービスは、Add-AzTrafficManagerEndpointConfig または New-AzTrafficManagerEndpointの 'targetResourceId' パラメーターを使用して指定します。The service is specified using the 'targetResourceId' parameter of Add-AzTrafficManagerEndpointConfig or New-AzTrafficManagerEndpoint.
  • 'Target' と 'EndpointLocation' はTargetResourceId で指定されます。The 'Target' and 'EndpointLocation' are implied by the TargetResourceId.
  • "Weight" の指定は省略できます。Specifying the 'Weight' is optional. Weight が使用されるのは、プロファイルがトラフィック ルーティング方法として 'Weighted' を使用するように構成されている場合のみです。Weights are only used if the profile is configured to use the 'Weighted' traffic-routing method. それ以外の場合は、無視されます。Otherwise, they are ignored. 指定する場合、値は 1 から 1000 までの数値である必要があります。If specified, the value must be a number between 1 and 1000. 既定値は '1' です。The default value is '1'.
  • "Priority" の指定は省略できます。Specifying the 'Priority' is optional. Priority が使用されるのは、プロファイルがトラフィック ルーティング方法として 'Priority' を使用するように構成されている場合のみです。Priorities are only used if the profile is configured to use the 'Priority' traffic-routing method. それ以外の場合は、無視されます。Otherwise, they are ignored. 有効な値は 1 から 1000 で、数が小さいほど優先順位が高くなります。Valid values are from 1 to 1000 with lower values indicating a higher priority. 1 つのエンドポイントに指定した場合は、すべてのエンドポイントに指定する必要があります。If specified for one endpoint, they must be specified for all endpoints. 省略した場合は、1 から始まる既定値が、エンドポイントのリスト順に適用されます。If omitted, default values starting from '1' are applied in the order that the endpoints are listed.

例 1:Add-AzTrafficManagerEndpointConfig を使用して App Service エンドポイントを追加するExample 1: Adding App Service endpoints using Add-AzTrafficManagerEndpointConfig

この例では Traffic Manager プロファイルを作成し、Add-AzTrafficManagerEndpointConfig コマンドレットを使用して 2 つのアプリ サービス アプリ エンドポイントを追加します。In this example, we create a Traffic Manager profile and add two App Service endpoints using the Add-AzTrafficManagerEndpointConfig cmdlet.

$TmProfile = New-AzTrafficManagerProfile -Name myprofile -ResourceGroupName MyRG -TrafficRoutingMethod Performance -RelativeDnsName myapp -Ttl 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/"
$webapp1 = Get-AzWebApp -Name webapp1
Add-AzTrafficManagerEndpointConfig -EndpointName webapp1ep -TrafficManagerProfile $TmProfile -Type AzureEndpoints -TargetResourceId $webapp1.Id -EndpointStatus Enabled
$webapp2 = Get-AzWebApp -Name webapp2
Add-AzTrafficManagerEndpointConfig -EndpointName webapp2ep -TrafficManagerProfile $TmProfile -Type AzureEndpoints -TargetResourceId $webapp2.Id -EndpointStatus Enabled
Set-AzTrafficManagerProfile -TrafficManagerProfile $TmProfile

例 2:New-AzTrafficManagerEndpoint を使用して publicIpAddress エンドポイントを追加するExample 2: Adding a publicIpAddress endpoint using New-AzTrafficManagerEndpoint

この例では、パブリック IP アドレス リソースが Traffic Manager プロファイルに追加されます。In this example, a public IP address resource is added to the Traffic Manager profile. パブリック IP アドレスでは DNS 名が構成されている必要があります。また、パブリック IP アドレスは、VM の NIC、またはロード バランサーにバインドすることができます。The public IP address must have a DNS name configured, and can be bound either to the NIC of a VM or to a load balancer.

$ip = Get-AzPublicIpAddress -Name MyPublicIP -ResourceGroupName MyRG
New-AzTrafficManagerEndpoint -Name MyIpEndpoint -ProfileName MyProfile -ResourceGroupName MyRG -Type AzureEndpoints -TargetResourceId $ip.Id -EndpointStatus Enabled

外部エンドポイントの追加Adding External Endpoints

Traffic Manager は、外部エンドポイントを使用して、Azure の外部でホストされているサービスにトラフィックを送信します。Traffic Manager uses external endpoints to direct traffic to services hosted outside of Azure. Azure エンドポイントの場合と同様に、Add-AzTrafficManagerEndpointConfig の後に Set-AzTrafficManagerProfileまたは New-AzTrafficManagerEndpointを使用することによって、外部エンドポイントを追加できます。As with Azure endpoints, external endpoints can be added either using Add-AzTrafficManagerEndpointConfig followed by Set-AzTrafficManagerProfile, or New-AzTrafficManagerEndpoint.

外部エンドポイントを指定する場合は、次のことが当てはまります。When specifying external endpoints:

  • 'Target' パラメーターを使用してエンドポイントのドメイン名を指定する必要があります。The endpoint domain name must be specified using the 'Target' parameter
  • 'Performance' トラフィック ルーティング方法を使用する場合、'EndpointLocation' が必須です。If the 'Performance' traffic-routing method is used, the 'EndpointLocation' is required. それ以外の場合は省略可能です。Otherwise it is optional. 値には、有効な Azure リージョン名を指定する必要があります。The value must be a valid Azure region name.
  • Azure エンドポイントについては、'Weight' と 'Priority' は省略可能です。The 'Weight' and 'Priority' are optional.

例 1:Add-AzTrafficManagerEndpointConfigSet-AzTrafficManagerProfile を使用して外部エンドポイントを追加するExample 1: Adding external endpoints using Add-AzTrafficManagerEndpointConfig and Set-AzTrafficManagerProfile

この例では、Traffic Manager プロファイルを作成し、2 つの外部エンドポイントを追加して、変更をコミットします。In this example, we create a Traffic Manager profile, add two external endpoints, and commit the changes.

$TmProfile = New-AzTrafficManagerProfile -Name myprofile -ResourceGroupName MyRG -TrafficRoutingMethod Performance -RelativeDnsName myapp -Ttl 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/"
Add-AzTrafficManagerEndpointConfig -EndpointName eu-endpoint -TrafficManagerProfile $TmProfile -Type ExternalEndpoints -Target app-eu.contoso.com -EndpointLocation "North Europe" -EndpointStatus Enabled
Add-AzTrafficManagerEndpointConfig -EndpointName us-endpoint -TrafficManagerProfile $TmProfile -Type ExternalEndpoints -Target app-us.contoso.com -EndpointLocation "Central US" -EndpointStatus Enabled
Set-AzTrafficManagerProfile -TrafficManagerProfile $TmProfile

例 2:New-AzTrafficManagerEndpoint を使用して外部エンドポイントを追加するExample 2: Adding external endpoints using New-AzTrafficManagerEndpoint

この例では、既存のプロファイルに外部エンドポイントを追加しています。In this example, we add an external endpoint to an existing profile. プロファイルは、プロファイル名とリソース グループ名を使用して指定します。The profile is specified using the profile and resource group names.

New-AzTrafficManagerEndpoint -Name eu-endpoint -ProfileName MyProfile -ResourceGroupName MyRG -Type ExternalEndpoints -Target app-eu.contoso.com -EndpointStatus Enabled

"入れ子" になったエンドポイントの追加Adding 'Nested' endpoints

Traffic Manager プロファイルごとに 1 つのトラフィック ルーティング方法を指定します。Each Traffic Manager profile specifies a single traffic-routing method. ただし、単一の Traffic Manager プロファイルで提供されるものよりも高度なトラフィック ルーティングが必要になるシナリオもあります。However, there are scenarios that require more sophisticated traffic routing than the routing provided by a single Traffic Manager profile. Traffic Manager プロファイルを入れ子にして、複数のトラフィック ルーティング方法の利点を組み合わせることができます。You can nest Traffic Manager profiles to combine the benefits of more than one traffic-routing method. 入れ子になったプロファイルを使用すると、既定の Traffic Manager の動作はオーバーライドされ、より大規模で複雑なアプリケーション デプロイをサポートできます。Nested profiles allow you to override the default Traffic Manager behavior to support larger and more complex application deployments. 詳細なサンプルについては、「入れ子になった Traffic Manager プロファイル」をご覧ください。For more detailed examples, see Nested Traffic Manager profiles.

入れ子になったエンドポイントは、親プロファイルで特定のエンドポイントの種類 "NestedEndpoints" を使って構成します。Nested endpoints are configured at the parent profile, using a specific endpoint type, 'NestedEndpoints'. 入れ子になったエンドポイントを指定する場合は、次のことが当てはまります。When specifying nested endpoints:

  • エンドポイントは、'targetResourceId' パラメーターを使用して指定する必要があります。The endpoint must be specified using the 'targetResourceId' parameter
  • 'Performance' トラフィック ルーティング方法を使用する場合、'EndpointLocation' が必須です。If the 'Performance' traffic-routing method is used, the 'EndpointLocation' is required. それ以外の場合は省略可能です。Otherwise it is optional. 値には、有効な Azure リージョン名を指定する必要があります。The value must be a valid Azure region name.
  • Azure エンドポイントについては、'Weight' と 'Priority' は省略可能です。The 'Weight' and 'Priority' are optional, as for Azure endpoints.
  • 'MinChildEndpoints' パラメーターは省略可能で、The 'MinChildEndpoints' parameter is optional. 既定値は '1' です。The default value is '1'. 利用可能なエンドポイントの数がこのしきい値を下回った場合、親プロファイルは子プロファイルを '機能低下' と見なし、トラフィックを親プロファイルの他のエンドポイントにトラフィックを振り向けます。If the number of available endpoints falls below this threshold, the parent profile considers the child profile 'degraded' and diverts traffic to the other endpoints in the parent profile.

例 1:Add-AzTrafficManagerEndpointConfigSet-AzTrafficManagerProfile を使用して入れ子にされたエンドポイントを追加するExample 1: Adding nested endpoints using Add-AzTrafficManagerEndpointConfig and Set-AzTrafficManagerProfile

この例では、Traffic Manager の子プロファイルと親プロファイルを新たに作成します。入れ子になったエンドポイントとして子を親に追加して変更をコミットします。In this example, we create new Traffic Manager child and parent profiles, add the child as a nested endpoint to the parent, and commit the changes.

$child = New-AzTrafficManagerProfile -Name child -ResourceGroupName MyRG -TrafficRoutingMethod Priority -RelativeDnsName child -Ttl 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/"
$parent = New-AzTrafficManagerProfile -Name parent -ResourceGroupName MyRG -TrafficRoutingMethod Performance -RelativeDnsName parent -Ttl 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/"
Add-AzTrafficManagerEndpointConfig -EndpointName child-endpoint -TrafficManagerProfile $parent -Type NestedEndpoints -TargetResourceId $child.Id -EndpointStatus Enabled -EndpointLocation "North Europe" -MinChildEndpoints 2
Set-AzTrafficManagerProfile -TrafficManagerProfile $parent

簡潔にするために、この例では、子プロファイルや親プロファイルには他のエンドポイントを追加していません。For brevity in this example, we did not add any other endpoints to the child or parent profiles.

例 2:New-AzTrafficManagerEndpoint を使用して入れ子にされたエンドポイントを追加するExample 2: Adding nested endpoints using New-AzTrafficManagerEndpoint

この例では、既存の親プロファイルに、入れ子になったエンドポイントとして既存の子プロファイルを追加しています。In this example, we add an existing child profile as a nested endpoint to an existing parent profile. プロファイルは、プロファイル名とリソース グループ名を使用して指定します。The profile is specified using the profile and resource group names.

$child = Get-AzTrafficManagerEndpoint -Name child -ResourceGroupName MyRG
New-AzTrafficManagerEndpoint -Name child-endpoint -ProfileName parent -ResourceGroupName MyRG -Type NestedEndpoints -TargetResourceId $child.Id -EndpointStatus Enabled -EndpointLocation "North Europe" -MinChildEndpoints 2

別のサブスクリプションからのエンドポイントの追加Adding endpoints from another subscription

Traffic Manager では、別のサブスクリプションからのエンドポイントを操作できます。Traffic Manager can work with endpoints from different subscriptions. 追加するエンドポイントがあるサブスクリプションに切り替えて、Traffic Manager に必要な入力を取得する必要があります。You need to switch to the subscription with the endpoint you want to add to retrieve the needed input to Traffic Manager. その後、Traffic Manager プロファイルがあるサブスクリプションに切り替えて、そのサブスクリプションにエンドポイントを追加する必要があります。Then you need to switch to the subscriptions with the Traffic Manager profile, and add the endpoint to it. 次の例は、パブリック IP アドレスを使ってこれを行う方法を示しています。The below example shows how to do this with a public IP address.

Set-AzContext -SubscriptionId $EndpointSubscription
$ip = Get-AzPublicIpAddress -Name $IpAddressName -ResourceGroupName $EndpointRG

Set-AzContext -SubscriptionId $trafficmanagerSubscription
New-AzTrafficManagerEndpoint -Name $EndpointName -ProfileName $ProfileName -ResourceGroupName $TrafficManagerRG -Type AzureEndpoints -TargetResourceId $ip.Id -EndpointStatus Enabled

Traffic Manager エンドポイントの更新Update a Traffic Manager Endpoint

既存の Traffic Manager エンドポイントを更新する方法は 2 通りあります。There are two ways to update an existing Traffic Manager endpoint:

  1. Get-AzTrafficManagerProfile を使用して Traffic Manager プロファイルを取得し、プロファイル内のエンドポイントのプロパティを更新した後、Set-AzTrafficManagerProfile を使用して変更をコミットします。Get the Traffic Manager profile using Get-AzTrafficManagerProfile, update the endpoint properties within the profile, and commit the changes using Set-AzTrafficManagerProfile. この方法の利点は、1 回の操作で複数のエンドポイントを更新できることです。This method has the advantage of being able to update more than one endpoint in a single operation.
  2. Get-AzTrafficManagerEndpoint を使用して Traffic Manager エンドポイントを取得し、エンドポイントのプロパティを更新した後、Set-AzTrafficManagerEndpoint を使用して変更をコミットします。Get the Traffic Manager endpoint using Get-AzTrafficManagerEndpoint, update the endpoint properties, and commit the changes using Set-AzTrafficManagerEndpoint. この方法は、プロファイル内の Endpoints 配列にインデックスを作成する必要がないため、より単純です。This method is simpler, since it does not require indexing into the Endpoints array in the profile.

例 1:1: Get-AzTrafficManagerProfileSet-AzTrafficManagerProfile を使用してエンドポイントを更新するExample 1: Updating endpoints using Get-AzTrafficManagerProfile and Set-AzTrafficManagerProfile

この例では、既存のプロファイル内の 2 つのエンドポイントの優先度を変更します。In this example, we modify the priority on two endpoints within an existing profile.

$TmProfile = Get-AzTrafficManagerProfile -Name myprofile -ResourceGroupName MyRG
$TmProfile.Endpoints[0].Priority = 2
$TmProfile.Endpoints[1].Priority = 1
Set-AzTrafficManagerProfile -TrafficManagerProfile $TmProfile

例 2:Get-AzTrafficManagerEndpointSet-AzTrafficManagerEndpoint を使用してエンドポイントを更新するExample 2: Updating an endpoint using Get-AzTrafficManagerEndpoint and Set-AzTrafficManagerEndpoint

この例では、既存のプロファイル内の 1 つのエンドポイントの重み付けを変更します。In this example, we modify the weight of a single endpoint in an existing profile.

$endpoint = Get-AzTrafficManagerEndpoint -Name myendpoint -ProfileName myprofile -ResourceGroupName MyRG -Type ExternalEndpoints
$endpoint.Weight = 20
Set-AzTrafficManagerEndpoint -TrafficManagerEndpoint $endpoint

エンドポイントとプロファイルの有効化と無効化Enabling and Disabling Endpoints and Profiles

Traffic Manager を使用すると、プロファイル全体だけでなく、個々のエンドポイントを有効にしたり無効にしたりすることができます。Traffic Manager allows individual endpoints to be enabled and disabled, as well as allowing enabling and disabling of entire profiles. これらの変更は、エンドポイントまたはプロファイルのリソースを取得、更新、設定することで実行できます。These changes can be made by getting/updating/setting the endpoint or profile resources. このような一般的な操作を合理化するために、専用のコマンドレットを使用した操作もサポートされています。To streamline these common operations, they are also supported via dedicated cmdlets.

例 1:Traffic Manager プロファイルを有効または無効にするExample 1: Enabling and disabling a Traffic Manager profile

Traffic Manager プロファイルを有効にするには、Enable-AzTrafficManagerProfile を使用します。To enable a Traffic Manager profile, use Enable-AzTrafficManagerProfile. プロファイルは、プロファイル オブジェクトを使用して指定できます。The profile can be specified using a profile object. プロファイル オブジェクトは、パイプライン経由、または '-TrafficManagerProfile' パラメーターを使用して渡すことができます。The profile object can be passed via the pipeline or by using the '-TrafficManagerProfile' parameter. この例では、プロファイル名とリソース グループ名でプロファイルを指定します。In this example, we specify the profile by the profile and resource group name.

Enable-AzTrafficManagerProfile -Name MyProfile -ResourceGroupName MyResourceGroup

Traffic Manager プロファイルを無効にするには:To disable a Traffic Manager profile:

Disable-AzTrafficManagerProfile -Name MyProfile -ResourceGroupName MyResourceGroup

Disable-AzTrafficManagerProfile コマンドレットでは、確認を求めるメッセージが表示されます。The Disable-AzTrafficManagerProfile cmdlet prompts for confirmation. '-Force' パラメーターを使用すると、このプロンプトを表示しないようにすることができます。This prompt can be suppressed using the '-Force' parameter.

例 2:Traffic Manager エンドポイントを有効または無効にするExample 2: Enabling and disabling a Traffic Manager endpoint

Traffic Manager エンドポイントを無効にするには、Enable-AzTrafficManagerEndpoint を使用します。To enable a Traffic Manager endpoint, use Enable-AzTrafficManagerEndpoint. エンドポイントの指定には次の 2 つの方法があります。There are two ways to specify the endpoint

  1. パイプライン経由、または '-TrafficManagerEndpoint' パラメーターを使用して渡された TrafficManagerEndpoint オブジェクトを使用するUsing a TrafficManagerEndpoint object passed via the pipeline or using the '-TrafficManagerEndpoint' parameter
  2. エンドポイント名、エンドポイントの種類、プロファイル名、リソース グループ名を使用するUsing the endpoint name, endpoint type, profile name, and resource group name:
Enable-AzTrafficManagerEndpoint -Name MyEndpoint -Type AzureEndpoints -ProfileName MyProfile -ResourceGroupName MyRG

同様に、Traffic Manager エンドポイントを無効にするには、次のように入力します。Similarly, to disable a Traffic Manager endpoint:

Disable-AzTrafficManagerEndpoint -Name MyEndpoint -Type AzureEndpoints -ProfileName MyProfile -ResourceGroupName MyRG -Force

Disable-AzTrafficManagerProfile と同様に、Disable-AzTrafficManagerEndpoint コマンドレットでも、確認を求めるメッセージが表示されます。As with Disable-AzTrafficManagerProfile, the Disable-AzTrafficManagerEndpoint cmdlet prompts for confirmation. '-Force' パラメーターを使用すると、このプロンプトを表示しないようにすることができます。This prompt can be suppressed using the '-Force' parameter.

Traffic Manager エンドポイントの削除Delete a Traffic Manager Endpoint

個々のエンドポイントを削除するには、Remove-AzTrafficManagerEndpoint コマンドレットを使用します。To remove individual endpoints, use the Remove-AzTrafficManagerEndpoint cmdlet:

Remove-AzTrafficManagerEndpoint -Name MyEndpoint -Type AzureEndpoints -ProfileName MyProfile -ResourceGroupName MyRG

このコマンドレットでは、確認を求めるメッセージが表示されます。This cmdlet prompts for confirmation. '-Force' パラメーターを使用すると、このプロンプトを表示しないようにすることができます。This prompt can be suppressed using the '-Force' parameter.

Traffic Manager プロファイルの削除Delete a Traffic Manager Profile

Traffic Manager プロファイルを削除するには、プロファイル名とリソース グループ名を指定して、Remove-AzTrafficManagerProfile コマンドレットを使用します。To delete a Traffic Manager profile, use the Remove-AzTrafficManagerProfile cmdlet, specifying the profile and resource group names:

Remove-AzTrafficManagerProfile -Name MyProfile -ResourceGroupName MyRG [-Force]

このコマンドレットでは、確認を求めるメッセージが表示されます。This cmdlet prompts for confirmation. '-Force' パラメーターを使用すると、このプロンプトを表示しないようにすることができます。This prompt can be suppressed using the '-Force' parameter.

プロファイル オブジェクトを使用して、削除するプロファイルを指定することもできます。The profile to be deleted can also be specified using a profile object:

$TmProfile = Get-AzTrafficManagerProfile -Name MyProfile -ResourceGroupName MyRG
Remove-AzTrafficManagerProfile -TrafficManagerProfile $TmProfile [-Force]

また、このシーケンスをパイプすることもできます。This sequence can also be piped:

Get-AzTrafficManagerProfile -Name MyProfile -ResourceGroupName MyRG | Remove-AzTrafficManagerProfile [-Force]

次の手順Next steps

Traffic Manager の監視Traffic Manager monitoring

Traffic Manager のパフォーマンスに関する考慮事項Traffic Manager performance considerations