Использование PowerShell для управления диспетчером трафикаUsing PowerShell to manage Traffic Manager

Azure Resource Manager представляет собой предпочтительный интерфейс управления для служб в Azure.Azure Resource Manager is the preferred management interface for services in Azure. Профилями диспетчера трафика Azure можно управлять с помощью интерфейсов API и инструментов на основе Azure Resource Manager.Azure Traffic Manager profiles can be managed using Azure Resource Manager-based APIs and tools.

Примечание

Эта статья была изменена и теперь содержит сведения о новом модуле Az для Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Вы по-прежнему можете использовать модуль AzureRM, исправления ошибок для которого будут продолжать выпускаться как минимум до декабря 2020 г.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 (Знакомство с новым модулем Az для Azure PowerShell).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 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.

Каждый профиль диспетчера трафика представлен ресурсом типа TrafficManagerProfiles.Each Traffic Manager profile is represented by a resource of type 'TrafficManagerProfiles'. На уровне API REST каждый профиль имеет следующий 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 PowerShellSetting up Azure PowerShell

Примечание

Эта статья была изменена и теперь содержит сведения о новом модуле Az для Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Вы по-прежнему можете использовать модуль AzureRM, исправления ошибок для которого будут продолжать выпускаться как минимум до декабря 2020 г.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 (Знакомство с новым модулем Az для Azure PowerShell).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. Но так как ресурсы профиля диспетчера трафика являются глобальными, а не региональными, выбор расположения группы ресурсов никак не повлияет на работу диспетчера трафика Azure.However, since Traffic Manager profile resources are global, not regional, the choice of resource group location has no impact on Azure Traffic Manager.

Создание профиля диспетчера трафикаCreate a Traffic Manager Profile

Чтобы создать профиль диспетчера трафика, используйте командлет 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 Имя ресурса профиля диспетчера трафика.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 Задает часть DNS-имени с именем узла, которое предоставляется этим профилем диспетчера трафика.Specifies the hostname portion of the DNS name provided by this Traffic Manager profile. Это значение объединяется с DNS-именем домена, с помощью которого диспетчер трафика Azure формирует полное доменное имя профиля.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.'
Срок жизниTTL Задает срок жизни запроса DNS в секундах.Specifies the DNS Time-to-Live (TTL), in seconds. Это значение срока жизни дает локальным сопоставителям DNS и DNS-клиентам понять, в течение какого срока нужно хранить в кэше ответы 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 и возвращает соответствующий объект профиля в 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. Дополнительные сведения о добавлении конечных точек в профиль диспетчера трафика см. в разделе о добавлении конечных точек диспетчера трафика.For more information about adding endpoints to a Traffic Manager profile, see Adding Traffic Manager Endpoints.

Получение профиля диспетчера трафикаGet a Traffic Manager Profile

Получить существующий объект профиля диспетчера трафика можно с помощью командлета Get-AzTrafficManagerProfle:To retrieve an existing Traffic Manager profile object, use the Get-AzTrafficManagerProfle cmdlet:

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

Этот командлет возвращает профиль объекта трафика.This cmdlet returns a Traffic Manager profile object.

Изменение профиля диспетчера трафикаUpdate a Traffic Manager Profile

Изменение профилей диспетчера трафика выполняется в три этапа.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.

В следующем примере показано, как изменить в профиле срок жизни.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

Существует три типа конечных точек диспетчера трафика.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. Вложенные конечные точки используются для создания вложенных иерархий профилей диспетчера трафика.Nested endpoints are used to construct nested hierarchies of Traffic Manager profiles. Вложенные конечные точки позволяют создавать расширенные конфигурации маршрутизации трафика для сложных приложений.Nested endpoints enable advanced traffic-routing configurations for complex applications.

Конечные точки всех трех типов можно добавлять двумя способами.In all three cases, endpoints can be added in two ways:

  1. С помощью описанных выше трех шагов.Using a 3-step process described previously. Этот метод удобен тем, что позволяет в ходе одного обновления внести несколько изменений в настройки конечной точки.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. Он добавляет конечную точку в существующий профиль диспетчера трафика за одну операцию.This cmdlet adds an endpoint to an existing Traffic Manager profile in a single operation.

Добавление конечных точек AzureAdding Azure Endpoints

Конечные точки Azure ссылаются на службы, размещенные в Azure.Azure endpoints reference services hosted in Azure. Поддерживаются два типа конечных точек Azure.Two types of Azure endpoints are supported:

  1. Служба приложений AzureAzure App Service
  2. Ресурсы Azure PublicIpAddress, которые могут подключаться к подсистеме балансировки нагрузки или к сетевому адаптеру виртуальной машины.Azure PublicIpAddress resources (which can be attached to a load-balancer or a virtual machine NIC). Для использования в диспетчере трафика конечной точке publicIpAddress должно быть назначено DNS-имя.The PublicIpAddress must have a DNS name assigned to be used in Traffic Manager.

В каждом случае:In each case:

  • Для указания службы используется параметр targetResourceId командлета Add-AzTrafficManagerEndpointConfig или New-AzTrafficManagerEndpoint.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. Если приоритет указан для одной конечной точки, он должен указываться и для всех остальных конечных точек.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: Добавление конечных точек службы app с использованиемAdd-AzTrafficManagerEndpointConfigExample 1: Adding App Service endpoints using Add-AzTrafficManagerEndpointConfig

В этом примере мы создадим профиль диспетчера трафика и добавим две конечные точки службы приложений с помощью командлета Add-AzTrafficManagerEndpointConfig.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. Добавление конечной точки publicIpAddress с помощью командлета New-AzTrafficManagerEndpointExample 2: Adding a publicIpAddress endpoint using New-AzTrafficManagerEndpoint

В этом примере мы добавляем в профиль диспетчера трафика ресурс с общедоступным IP-адресом.In this example, a public IP address resource is added to the Traffic Manager profile. Общедоступный IP-адрес должен включать DNS-имя и может быть привязан к сетевому адаптеру виртуальной машины или к балансировщику нагрузки.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

Диспетчер трафика использует внешние конечные точки для передачи трафика в службы, размещенные за пределами 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
  • EndpointLocation является обязательным параметром, если используется метод маршрутизации трафика Performance.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.
  • Параметры Weight и Priority являются необязательными.The 'Weight' and 'Priority' are optional.

Пример 1. Добавление внешних конечных точек с помощью командлетов Add-AzTrafficManagerEndpointConfig и Set-AzTrafficManagerProfileExample 1: Adding external endpoints using Add-AzTrafficManagerEndpointConfig and Set-AzTrafficManagerProfile

В этом примере мы создаем профиль диспетчера трафика, добавляем в него две внешние конечные точки и фиксируем изменения.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-AzTrafficManagerEndpointExample 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

Каждый профиль диспетчера трафика определяет один метод маршрутизации трафика.Each Traffic Manager profile specifies a single traffic-routing method. Но бывают случаи, когда требуется более сложная маршрутизация трафика, чем та, которую может обеспечить отдельный профиль диспетчера трафика.However, there are scenarios that require more sophisticated traffic routing than the routing provided by a single Traffic Manager profile. Чтобы воспользоваться преимуществами нескольких методов маршрутизации трафика, можно выполнить вложение профилей диспетчера трафика.You can nest Traffic Manager profiles to combine the benefits of more than one traffic-routing method. Вложенные профили позволяют переопределить стандартное поведение диспетчера трафика, реализуя поддержку крупных и сложных развертываний приложений.Nested profiles allow you to override the default Traffic Manager behavior to support larger and more complex application deployments. Более подробные примеры см. в статье Вложенные профили диспетчера трафика.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
  • EndpointLocation является обязательным параметром, если используется метод маршрутизации трафика Performance.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.
  • Параметры Weight и Priority для конечных точек Azure являются необязательными.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-AzTrafficManagerEndpointConfig и Set-AzTrafficManagerProfileExample 1: Adding nested endpoints using Add-AzTrafficManagerEndpointConfig and Set-AzTrafficManagerProfile

В этом примере мы создаем новые дочерний и родительский профили диспетчера трафика, добавляем дочерний профиль как вложенный в родительский профиль и фиксируем изменения.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-AzTrafficManagerEndpointExample 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 can work with endpoints from different subscriptions. Вам нужно переключиться на подписку с конечной точкой, которую вы хотите добавить для получения необходимых входных данных для диспетчера трафика.You need to switch to the subscription with the endpoint you want to add to retrieve the needed input to 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

Обновление конечной точки диспетчера трафикаUpdate a Traffic Manager Endpoint

Есть два способа обновления существующей конечной точки диспетчера трафика.There are two ways to update an existing Traffic Manager endpoint:

  1. Получить профиль диспетчера трафика с помощью командлета Get-AzTrafficManagerProfile, обновить свойства конечной точки в профиле и зафиксировать изменения с помощью Set-AzTrafficManagerProfile.Get the Traffic Manager profile using Get-AzTrafficManagerProfile, update the endpoint properties within the profile, and commit the changes using Set-AzTrafficManagerProfile. Этот метод удобен тем, что позволяет в ходе одной операции обновления изменить настройки нескольких конечных точек.This method has the advantage of being able to update more than one endpoint in a single operation.
  2. Получить конечную точку диспетчера трафика с помощью командлета Get-AzTrafficManagerEndpoint, обновить свойства конечной точки и зафиксировать изменения с помощью командлета Set-AzTrafficManagerEndpoint.Get the Traffic Manager endpoint using Get-AzTrafficManagerEndpoint, update the endpoint properties, and commit the changes using Set-AzTrafficManagerEndpoint. Этот метод проще, так как он не требует индексации массива конечных точек в профиле.This method is simpler, since it does not require indexing into the Endpoints array in the profile.

Пример 1. Обновление конечных точек с помощью командлетов Get-AzTrafficManagerProfile и Set-AzTrafficManagerProfileExample 1: Updating endpoints using Get-AzTrafficManagerProfile and Set-AzTrafficManagerProfile

В этом примере мы изменим приоритет двух конечных точек в существующем профиле.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-AzTrafficManagerEndpoint и Set-AzTrafficManagerEndpointExample 2: Updating an endpoint using Get-AzTrafficManagerEndpoint and Set-AzTrafficManagerEndpoint

В этом примере мы изменим вес одной конечной точки в существующем профиле.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 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. Включение и отключение профиля диспетчера трафикаExample 1: Enabling and disabling a Traffic Manager profile

Для включения профиля диспетчера трафика используйте командлет 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

Отключение профиля диспетчера трафика: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. Включение и отключение конечной точки диспетчера трафикаExample 2: Enabling and disabling a Traffic Manager endpoint

Для включения конечной точки диспетчера трафика используйте командлет Enable-AzTrafficManagerEndpoint.To enable a Traffic Manager endpoint, use Enable-AzTrafficManagerEndpoint. Задать конечную точку можно двумя способами: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

Аналогичным образом можно отключить конечную точку диспетчера трафика: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.

Удаление конечной точки диспетчера трафика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.

Удаление профиля диспетчера трафикаDelete a Traffic Manager Profile

Чтобы удалить профиль диспетчера трафика, используйте командлет 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 monitoring

Рекомендации по безопасности для диспетчера трафикаTraffic Manager performance considerations