Uso di PowerShell per Gestione trafficoUsing PowerShell to manage Traffic Manager

Azure Resource Manager è l'interfaccia di gestione preferita dei servizi in Azure.Azure Resource Manager is the preferred management interface for services in Azure. I profili di Gestione traffico di Azure possono ora essere gestiti usando le API e gli strumenti basati su Azure Resource Manager.Azure Traffic Manager profiles can be managed using Azure Resource Manager-based APIs and tools.

Modello di risorsaResource model

Gestione traffico di Azure viene configurato utilizzando una serie di impostazioni denominate "profilo di Gestione traffico".Azure Traffic Manager is configured using a collection of settings called a Traffic Manager profile. Questo profilo include le impostazioni DNS, di routing del traffico, di monitoraggio dell'endpoint e un elenco degli endpoint di servizio a cui viene indirizzato il traffico.This profile contains DNS settings, traffic routing settings, endpoint monitoring settings, and a list of service endpoints to which traffic is routed.

Ogni profilo di Gestione traffico è rappresentato da una risorsa di tipo "TrafficManagerProfiles".Each Traffic Manager profile is represented by a resource of type 'TrafficManagerProfiles'. A livello di API REST, l'URI per ogni profilo è analogo al seguente: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}

Configurazione di Azure PowerShellSetting up Azure PowerShell

In queste istruzioni viene usato Microsoft Azure PowerShell.These instructions use Microsoft Azure PowerShell. L'articolo seguente illustra come installare e configurare Azure PowerShell.The following article explains how to install and configure Azure PowerShell.

Negli esempi inclusi in questo articolo si presuppone che esista un gruppo di risorse.The examples in this article assume that you have an existing resource group. È possibile creare un gruppo di risorse usando il comando seguente:You can create a resource group using the following command:

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

Nota

Azure Resource Manager richiede che tutti i gruppi di risorse specifichino un percorso,Azure Resource Manager requires that all resource groups have a location. che viene usato come percorso predefinito per le risorse create in questo gruppo di risorse.This location is used as the default for resources created in that resource group. Tuttavia, dal momento che tutte le risorse del profilo di Gestione traffico sono globali (non locali), la scelta del percorso relativo al gruppo di risorse non ha alcun impatto sul servizio Gestione traffico di Azure.However, since Traffic Manager profile resources are global, not regional, the choice of resource group location has no impact on Azure Traffic Manager.

Creazione di un profilo di Gestione trafficoCreate a Traffic Manager Profile

Per creare un profilo di Gestione traffico, usare il cmdlet New-AzureRmTrafficManagerProfile:To create a Traffic Manager profile, use the New-AzureRmTrafficManagerProfile cmdlet:

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

La tabella seguente descrive i parametri:The following table describes the parameters:

ParametroParameter DescrizioneDescription
NomeName Il nome della risorsa per la risorsa del profilo di Gestione traffico.The resource name for the Traffic Manager profile resource. I profili dello stesso gruppo di risorse devono disporre di nomi univoci.Profiles in the same resource group must have unique names. Tale nome è diverso rispetto a quello DNS utilizzato per le query DNS.This name is separate from the DNS name used for DNS queries.
ResourceGroupNameResourceGroupName Il nome del gruppo di risorse che include la risorsa del profilo.The name of the resource group containing the profile resource.
TrafficRoutingMethodTrafficRoutingMethod Indica il metodo di routing del traffico usato per determinare quale endpoint viene restituito in risposta alle query DNS.Specifies the traffic-routing method used to determine which endpoint is returned in response a DNS query. I valori possibili sono "Performance", "'Weighted" e "Priority".Possible values are 'Performance', 'Weighted' or 'Priority'.
RelativeDnsNameRelativeDnsName Indica la parte hostname del nome DNS fornito da questo profilo di Gestione traffico.Specifies the hostname portion of the DNS name provided by this Traffic Manager profile. Questo valore viene combinato con il nome del dominio DNS usato da Gestione traffico di Azure per formare il nome di dominio completo del profilo.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. Ad esempio, l'impostazione del valore di "contoso" diventa "contoso.trafficmanager.net".For example, setting the value of 'contoso' becomes 'contoso.trafficmanager.net.'
TTLTTL Specifica la durata (TTL) DNS in secondi.Specifies the DNS Time-to-Live (TTL), in seconds. In questo modo, i resolver locali e i client DNS sono informati sulla durata della memorizzazione nella cache delle risposte DNS per il profilo di Gestione traffico.This TTL informs the Local DNS resolvers and DNS clients how long to cache DNS responses for this Traffic Manager profile.
MonitorProtocolMonitorProtocol Indica il protocollo da usare per monitorare lo stato di integrità dell'endpoint.Specifies the protocol to use to monitor endpoint health. I valori possibili sono "HTTP" e "HTTPS".Possible values are 'HTTP' and 'HTTPS'.
MonitorPortMonitorPort Indica la porta TCP da usare per monitorare lo stato di integrità dell'endpoint.Specifies the TCP port used to monitor endpoint health.
MonitorPathMonitorPath Indica il percorso relativo al nome di dominio dell'endpoint usato per verificare l'integrità dell'endpoint.Specifies the path relative to the endpoint domain name used to probe for endpoint health.

Il cmdlet consente di creare un profilo di Gestione traffico in Azure e restituisce un oggetto di profilo corrispondente a PowerShell.The cmdlet creates a Traffic Manager profile in Azure and returns a corresponding profile object to PowerShell. A questo punto, il profilo non contiene endpoint.At this point, the profile does not contain any endpoints. Per altre informazioni sull'aggiunta di endpoint a un profilo di Gestione traffico, vedere Aggiunta di endpoint a Gestione traffico.For more information about adding endpoints to a Traffic Manager profile, see Adding Traffic Manager Endpoints.

Visualizzazione di un profilo di Gestione trafficoGet a Traffic Manager Profile

Per recuperare un oggetto profilo di Gestione traffico esistente, usare il cmdlet Get-AzureRmTrafficManagerProfle:To retrieve an existing Traffic Manager profile object, use the Get-AzureRmTrafficManagerProfle cmdlet:

$profile = Get-AzureRmTrafficManagerProfile -Name MyProfile -ResourceGroupName MyRG

Questo cmdlet restituisce un oggetto profilo di Gestione traffico.This cmdlet returns a Traffic Manager profile object.

Aggiornare un profilo di Gestione trafficoUpdate a Traffic Manager Profile

La modifica dei profili di Gestione traffico prevede un processo in 3 passaggi:Modifying Traffic Manager profiles follows a 3-step process:

  1. Recuperare il profilo usando Get-AzureRmTrafficManagerProfile oppure usare il profilo restituito da New-AzureRmTrafficManagerProfile.Retrieve the profile using Get-AzureRmTrafficManagerProfile or use the profile returned by New-AzureRmTrafficManagerProfile.
  2. Modificare il profilo.Modify the profile. È possibile aggiungere e rimuovere endpoint o modificare i parametri dell'endpoint o del profilo.You can add and remove endpoints or change endpoint or profile parameters. Queste modifiche sono operazioni offline.These changes are off-line operations. Si sta modificando solo l'oggetto locale in memoria che rappresenta il profilo.You are only changing the local object in memory that represents the profile.
  3. Confermare le modifiche usando il cmdlet Set-AzureRmTrafficManagerProfile.Commit your changes using the Set-AzureRmTrafficManagerProfile cmdlet.

Tutte le proprietà del profilo possono essere modificate, ad eccezione del valore RelativeDnsName del profilo.All profile properties can be changed except the profile's RelativeDnsName. Per modificare RelativeDnsName, è necessario eliminare il profilo e creare un nuovo profilo con un nuovo nome.To change the RelativeDnsName, you must delete profile and a new profile with a new name.

L'esempio seguente illustra come cambiare la durata (TTL) del profilo:The following example demonstrates how to change the profile's TTL:

$profile = Get-AzureRmTrafficManagerProfile -Name MyProfile -ResourceGroupName MyRG
$profile.Ttl = 300
Set-AzureRmTrafficManagerProfile -TrafficManagerProfile $profile

Sono disponibili tre tipi di endpoint di Gestione traffico:There are three types of Traffic Manager endpoints:

  1. I servizi Endpoint di Azure sono ospitati hosting in AzureAzure endpoints are services hosted in Azure
  2. I servizi Endpoint esterni sono ospitati all'esterno di AzureExternal endpoints are services hosted outside of Azure
  3. Gli endpoint annidati vengono usati per creare gerarchie annidate dei profili di Gestione traffico.Nested endpoints are used to construct nested hierarchies of Traffic Manager profiles. Gli endpoint annidati consentono configurazioni avanzate del routing del traffico per applicazioni complesse.Nested endpoints enable advanced traffic-routing configurations for complex applications.

In tutti e tre i casi è possibile aggiungere gli endpoint in due modi:In all three cases, endpoints can be added in two ways:

  1. Usando il processo in 3 passaggi descritto in precedenza.Using a 3-step process described previously. Il vantaggio di questo metodo consiste nel fatto che è possibile apportare diverse modifiche agli endpoint in un singolo aggiornamento.The advantage of this method is that several endpoint changes can be made in a single update.
  2. Mediante il cmdlet New-AzureRmTrafficManagerEndpoint.Using the New-AzureRmTrafficManagerEndpoint cmdlet. Questo cmdlet aggiunge un endpoint a un profilo di Gestione traffico esistente in una singola operazione.This cmdlet adds an endpoint to an existing Traffic Manager profile in a single operation.

Aggiunta di endpoint di AzureAdding Azure Endpoints

Gli endpoint di Azure fanno riferimento ai servizi ospitati in Azure.Azure endpoints reference services hosted in Azure. Sono attualmente supportati due tipi di endpoint di Azure:Two types of Azure endpoints are supported:

  1. App Web di Azure Azure Web Apps
  2. Risorse di tipo publicIpAddress di Azure, che possono essere associate a un servizio di bilanciamento del carico o a una scheda di interfaccia di rete di una macchina virtuale.Azure PublicIpAddress resources (which can be attached to a load-balancer or a virtual machine NIC). La risorsa di tipo PublicIpAddress deve avere un nome DNS assegnato da usare in Gestione traffico.The PublicIpAddress must have a DNS name assigned to be used in Traffic Manager.

In ogni caso:In each case:

  • Il servizio viene specificato usando il parametro "targetResourceId" di Add-AzureRmTrafficManagerEndpointConfig o New-AzureRmTrafficManagerEndpoint.The service is specified using the 'targetResourceId' parameter of Add-AzureRmTrafficManagerEndpointConfig or New-AzureRmTrafficManagerEndpoint.
  • TargetResourceId usa in modo implicito "Target" ed "EndpointLocation".The 'Target' and 'EndpointLocation' are implied by the TargetResourceId.
  • "Weight" è facoltativo ed è possibile scegliere se specificarlo.Specifying the 'Weight' is optional. I pesi vengono usati solo se il profilo è configurato per l'uso del metodo di routing del traffico "Weighted".Weights are only used if the profile is configured to use the 'Weighted' traffic-routing method. In caso contrario, vengono ignorati.Otherwise, they are ignored. Il valore deve essere un numero compreso tra 1 e 1000.If specified, the value must be a number between 1 and 1000. Il valore predefinito è "1".The default value is '1'.
  • "Priority" è facoltativo ed è possibile scegliere se specificarlo.Specifying the 'Priority' is optional. Le priorità vengono usate solo se il profilo è configurato per l'uso del metodo di routing del traffico "Priority".Priorities are only used if the profile is configured to use the 'Priority' traffic-routing method. In caso contrario, vengono ignorate.Otherwise, they are ignored. I valori validi sono compresi tra 1 e 1000 con i valori più bassi che indicano una priorità più alta.Valid values are from 1 to 1000 with lower values indicating a higher priority. Se si specifica questo valore per un endpoint, sarà necessario specificarlo per tutti gli endpoint.If specified for one endpoint, they must be specified for all endpoints. Se questo valore viene omesso, verranno applicati i valori predefiniti a partire da "1" nell'ordine in cui sono elencati gli endpoint.If omitted, default values starting from '1' are applied in the order that the endpoints are listed.

Esempio 1: Aggiunta di endpoint di App Web usando Add-AzureRmTrafficManagerEndpointConfigExample 1: Adding Web App endpoints using Add-AzureRmTrafficManagerEndpointConfig

In questo esempio viene creato un profilo di Gestione traffico e vengono aggiunti due endpoint di App Web usando il cmdlet Add-AzureRmTrafficManagerEndpointConfig.In this example, we create a Traffic Manager profile and add two Web App endpoints using the Add-AzureRmTrafficManagerEndpointConfig cmdlet.

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

Esempio 2: Aggiunta di un endpoint publicIpAddress usando New-AzureRmTrafficManagerEndpointExample 2: Adding a publicIpAddress endpoint using New-AzureRmTrafficManagerEndpoint

In questo esempio viene aggiunta una risorsa indirizzo IP pubblico al profilo di Gestione traffico.In this example, a public IP address resource is added to the Traffic Manager profile. L'indirizzo IP pubblico deve avere un nome DNS configurato e può essere associato alla NIC di una VM o a un servizio di bilanciamento del carico.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-AzureRmPublicIpAddress -Name MyPublicIP -ResourceGroupName MyRG
New-AzureRmTrafficManagerEndpoint -Name MyIpEndpoint -ProfileName MyProfile -ResourceGroupName MyRG -Type AzureEndpoints -TargetResourceId $ip.Id -EndpointStatus Enabled

Aggiunta di endpoint esterniAdding External Endpoints

Gestione traffico usa endpoint esterni per indirizzare il traffico ai servizi ospitati all'esterno di Azure.Traffic Manager uses external endpoints to direct traffic to services hosted outside of Azure. Come con gli endpoint di Azure, gli endpoint esterni possono essere aggiunti usando Add-AzureRmTrafficManagerEndpointConfig seguito da Set-AzureRmTrafficManagerProfile o New-AzureRMTrafficManagerEndpoint.As with Azure endpoints, external endpoints can be added either using Add-AzureRmTrafficManagerEndpointConfig followed by Set-AzureRmTrafficManagerProfile, or New-AzureRMTrafficManagerEndpoint.

Quando si specificano endpoint esterni:When specifying external endpoints:

  • Il nome di dominio dell'endpoint deve essere specificato con il parametro "Target"The endpoint domain name must be specified using the 'Target' parameter
  • "EndpointLocation" è obbligatorio se viene usato il metodo di routing del traffico "Performance".If the 'Performance' traffic-routing method is used, the 'EndpointLocation' is required. In caso contrario, è facoltativo.Otherwise it is optional. Il valore deve essere un nome di area di Azure valido.The value must be a valid Azure region name.
  • I parametri "Weight" e "Priority" sono facoltativi.The 'Weight' and 'Priority' are optional.

Esempio 1: Aggiunta di endpoint esterni usando Add-AzureRmTrafficManagerEndpointConfig e Set-AzureRmTrafficManagerProfileExample 1: Adding external endpoints using Add-AzureRmTrafficManagerEndpointConfig and Set-AzureRmTrafficManagerProfile

In questo esempio viene creato un profilo di Gestione traffico, vengono aggiunti due endpoint esterni e viene eseguito il commit delle modifiche.In this example, we create a Traffic Manager profile, add two external endpoints, and commit the changes.

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

Esempio 2: Aggiunta di endpoint esterni usando New-AzureRmTrafficManagerEndpointExample 2: Adding external endpoints using New-AzureRmTrafficManagerEndpoint

In questo esempio si aggiunge un endpoint esterno a un profilo esistente.In this example, we add an external endpoint to an existing profile. Il profilo viene specificato usando i nomi del gruppo di risorse e del profilo.The profile is specified using the profile and resource group names.

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

Aggiunta di endpoint 'annidati'Adding 'Nested' endpoints

Ciascun profilo di Gestione traffico specifica un solo metodo di routing del traffico.Each Traffic Manager profile specifies a single traffic-routing method. Esistono scenari che tuttavia richiedono un sistema di routing del traffico più avanzato anziché il routing fornito da un singolo profilo di Gestione traffico.However, there are scenarios that require more sophisticated traffic routing than the routing provided by a single Traffic Manager profile. È possibile annidare i profili di Gestione traffico per combinare i vantaggi offerti da più metodi di routing del traffico.You can nest Traffic Manager profiles to combine the benefits of more than one traffic-routing method. I profili annidati consentono di ignorare il comportamento predefinito di Gestione traffico per supportare distribuzioni di dimensioni maggiori e più complesse.Nested profiles allow you to override the default Traffic Manager behavior to support larger and more complex application deployments. Per esempi più dettagliati, vedere Profili annidati di Gestione traffico.For more detailed examples, see Nested Traffic Manager profiles.

Endpoint annidati vengono configurati nel profilo padre tramite un tipo di endpoint specifico, 'NestedEndpoints'.Nested endpoints are configured at the parent profile, using a specific endpoint type, 'NestedEndpoints'. Quando si specificano endpoint annidati:When specifying nested endpoints:

  • L'endpoint deve essere specificato usando il parametro "targetResourceId"The endpoint must be specified using the 'targetResourceId' parameter
  • "EndpointLocation" è obbligatorio se viene usato il metodo di routing del traffico "Performance".If the 'Performance' traffic-routing method is used, the 'EndpointLocation' is required. In caso contrario, è facoltativo.Otherwise it is optional. Il valore deve essere un nome di area di Azure valido.The value must be a valid Azure region name.
  • I parametri "Weight" e "Priority" sono facoltativi, come per gli endpoint di Azure.The 'Weight' and 'Priority' are optional, as for Azure endpoints.
  • Il parametro "MinChildEndpoints" è facoltativo.The 'MinChildEndpoints' parameter is optional. Il valore predefinito è "1".The default value is '1'. Se il numero di endpoint disponibili scende sotto questa soglia, il profilo padre considera il profilo figlio "degradato" con conseguente deviazione del traffico agli altri endpoint del profilo padre.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.

Esempio 1: Aggiunta di endpoint annidati usando Add-AzureRmTrafficManagerEndpointConfig e Set-AzureRmTrafficManagerProfileExample 1: Adding nested endpoints using Add-AzureRmTrafficManagerEndpointConfig and Set-AzureRmTrafficManagerProfile

In questo esempio vengono creati un nuovo profilo padre e un nuovo profilo figlio di Gestione traffico, il profilo figlio viene aggiunto come endpoint annidato nel profilo padre, quindi vengono confermate le modifiche.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-AzureRmTrafficManagerProfile -Name child -ResourceGroupName MyRG -TrafficRoutingMethod Priority -RelativeDnsName child -Ttl 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/"
$parent = New-AzureRmTrafficManagerProfile -Name parent -ResourceGroupName MyRG -TrafficRoutingMethod Performance -RelativeDnsName parent -Ttl 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/"
Add-AzureRmTrafficManagerEndpointConfig -EndpointName child-endpoint -TrafficManagerProfile $parent -Type NestedEndpoints -TargetResourceId $child.Id -EndpointStatus Enabled -EndpointLocation "North Europe" -MinChildEndpoints 2
Set-AzureRmTrafficManagerProfile -TrafficManagerProfile $profile

Per brevità, in questo esempio, non sono stati aggiunti altri endpoint al profilo padre o figlio.For brevity in this example, we did not add any other endpoints to the child or parent profiles.

Esempio 2: Aggiunta di endpoint annidati usando New-AzureRmTrafficManagerEndpointExample 2: Adding nested endpoints using New-AzureRmTrafficManagerEndpoint

In questo esempio viene aggiunto un profilo figlio esistente come endpoint annidato in un profilo padre esistente.In this example, we add an existing child profile as a nested endpoint to an existing parent profile. Il profilo viene specificato usando i nomi del gruppo di risorse e del profilo.The profile is specified using the profile and resource group names.

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

Aggiornare un endpoint di Gestione trafficoUpdate a Traffic Manager Endpoint

È possibile aggiornare un endpoint di Gestione traffico esistente in due modi:There are two ways to update an existing Traffic Manager endpoint:

  1. Ottenere il profilo di Gestione traffico mediante Get-AzureRmTrafficManagerProfile, aggiornare le proprietà dell'endpoint nel profilo ed eseguire il commit delle modifiche mediante Set-AzureRmTrafficManagerProfile.Get the Traffic Manager profile using Get-AzureRmTrafficManagerProfile, update the endpoint properties within the profile, and commit the changes using Set-AzureRmTrafficManagerProfile. Il vantaggio di questo metodo consiste nella possibilità di aggiornare più endpoint in una singola operazione.This method has the advantage of being able to update more than one endpoint in a single operation.
  2. Ottenere l'endpoint di Gestione traffico mediante Get-AzureRmTrafficManagerEndpoint, aggiornare le proprietà dell'endpoint ed eseguire il commit delle modifiche mediante Set-AzureRmTrafficManagerEndpoint.Get the Traffic Manager endpoint using Get-AzureRmTrafficManagerEndpoint, update the endpoint properties, and commit the changes using Set-AzureRmTrafficManagerEndpoint. Questo metodo è più semplice, perché non richiede l'indicizzazione nella matrice Endpoints nel profilo.This method is simpler, since it does not require indexing into the Endpoints array in the profile.

Esempio 1: Aggiornamento di endpoint usando Get-AzureRmTrafficManagerProfile e Set-AzureRmTrafficManagerProfileExample 1: Updating endpoints using Get-AzureRmTrafficManagerProfile and Set-AzureRmTrafficManagerProfile

In questo esempio viene modificata la priorità di due endpoint in un profilo esistente.In this example, we modify the priority on two endpoints within an existing profile.

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

Esempio 2: Aggiornamento di un endpoint usando Get-AzureRmTrafficManagerEndpoint e Set-AzureRmTrafficManagerEndpointExample 2: Updating an endpoint using Get-AzureRmTrafficManagerEndpoint and Set-AzureRmTrafficManagerEndpoint

In questo esempio viene modificato il peso di un singolo endpoint in un profilo esistente.In this example, we modify the weight of a single endpoint in an existing profile.

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

Abilitazione e disabilitazione di endpoint e profiliEnabling and Disabling Endpoints and Profiles

Gestione traffico consente l'abilitazione e la disabilitazione dei singoli endpoint, oltre a consentire l'abilitazione e la disabilitazione di interi profili.Traffic Manager allows individual endpoints to be enabled and disabled, as well as allowing enabling and disabling of entire profiles. Queste modifiche possono essere apportate ottenendo/aggiornando/impostando l'endpoint o le risorse del profilo.These changes can be made by getting/updating/setting the endpoint or profile resources. Per semplificare queste operazioni comuni, le modifiche sono supportate anche tramite cmdlet dedicati.To streamline these common operations, they are also supported via dedicated cmdlets.

Esempio 1: Abilitazione e disabilitazione di un profilo di Gestione trafficoExample 1: Enabling and disabling a Traffic Manager profile

Per abilitare un profilo di Gestione traffico, usare Enable-AzureRmTrafficManagerProfile.To enable a Traffic Manager profile, use Enable-AzureRmTrafficManagerProfile. Il profilo può essere specificato usando un oggetto profilo.The profile can be specified using a profile object. L'oggetto profilo può essere passato tramite la pipeline o usando il parametro '-TrafficManagerProfile'.The profile object can be passed via the pipeline or by using the '-TrafficManagerProfile' parameter. In questo esempio abbiamo specificato il profilo in base al nome del gruppo di risorse e profili.In this example, we specify the profile by the profile and resource group name.

Enable-AzureRmTrafficManagerProfile -Name MyProfile -ResourceGroupName MyResourceGroup

Per disabilitare un profilo di Gestione traffico:To disable a Traffic Manager profile:

Disable-AzureRmTrafficManagerProfile -Name MyProfile -ResourceGroupName MyResourceGroup

Il cmdlet Disable-AzureRmTrafficManagerProfile chiede la conferma.The Disable-AzureRmTrafficManagerProfile cmdlet prompts for confirmation. Questo messaggio può essere soppresso mediante il parametro "-Force".This prompt can be suppressed using the '-Force' parameter.

Esempio 2: Abilitazione e disabilitazione di un endpoint di Gestione trafficoExample 2: Enabling and disabling a Traffic Manager endpoint

Per abilitare un endpoint di Gestione traffico, usare Enable-AzureRmTrafficManagerEndpoint.To enable a Traffic Manager endpoint, use Enable-AzureRmTrafficManagerEndpoint. È possibile specificare l'endpoint in due modi:There are two ways to specify the endpoint

  1. Usando un oggetto TrafficManagerEndpoint passato tramite la pipeline o usando il parametro "-TrafficManagerEndpoint"Using a TrafficManagerEndpoint object passed via the pipeline or using the '-TrafficManagerEndpoint' parameter
  2. Usando il nome dell'endpoint, il tipo di endpoint, il nome del profilo e il nome del gruppo di risorse:Using the endpoint name, endpoint type, profile name, and resource group name:
Enable-AzureRmTrafficManagerEndpoint -Name MyEndpoint -Type AzureEndpoints -ProfileName MyProfile -ResourceGroupName MyRG

Analogamente, per disabilitare un endpoint di Gestione traffico:Similarly, to disable a Traffic Manager endpoint:

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

Come con Disable-AzureRmTrafficManagerProfile, il cmdlet Disable-AzureRmTrafficManagerEndpoint richiede una conferma.As with Disable-AzureRmTrafficManagerProfile, the Disable-AzureRmTrafficManagerEndpoint cmdlet prompts for confirmation. Questo messaggio può essere soppresso mediante il parametro "-Force".This prompt can be suppressed using the '-Force' parameter.

Eliminare un endpoint di Gestione trafficoDelete a Traffic Manager Endpoint

Per rimuovere singoli endpoint, usare il cmdlet Remove-AzureRmTrafficManagerEndpoint:To remove individual endpoints, use the Remove-AzureRmTrafficManagerEndpoint cmdlet:

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

Il cmdlet richiede una conferma.This cmdlet prompts for confirmation. Questo messaggio può essere soppresso mediante il parametro "-Force".This prompt can be suppressed using the '-Force' parameter.

Eliminare un profilo di Gestione trafficoDelete a Traffic Manager Profile

Per eliminare un profilo di Gestione traffico, usare il cmdlet Remove-AzureRmTrafficManagerProfile, specificando il nome del profilo e del gruppo di risorse:To delete a Traffic Manager profile, use the Remove-AzureRmTrafficManagerProfile cmdlet, specifying the profile and resource group names:

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

Il cmdlet richiede una conferma.This cmdlet prompts for confirmation. Questo messaggio può essere soppresso mediante il parametro "-Force".This prompt can be suppressed using the '-Force' parameter.

Inoltre, il profilo da eliminare può essere specificato utilizzando un oggetto di profilo:The profile to be deleted can also be specified using a profile object:

$profile = Get-AzureRmTrafficManagerProfile -Name MyProfile -ResourceGroupName MyRG
Remove-AzureRmTrafficManagerProfile -TrafficManagerProfile $profile [-Force]

Questa sequenza può anche essere inoltrata tramite pipe:This sequence can also be piped:

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

Passaggi successiviNext steps

Monitoraggio di Gestione trafficoTraffic Manager monitoring

Considerazioni sulle prestazioni di gestione trafficoTraffic Manager performance considerations