Condividi tramite

Set-AzureTrafficManagerEndpoint

  • Riferimento
Modulo:
Azure

Aggiorna le proprietà di un endpoint in un profilo di Gestione traffico.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

Set-AzureTrafficManagerEndpoint
   -DomainName <String>
   [-Location <String>]
   [-Type <String>]
   [-Status <String>]
   [-Weight <Int32>]
   [-MinChildEndpoints <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzureTrafficManagerEndpoint aggiorna le proprietà di un endpoint in un profilo di Gestione traffico di Microsoft Azure. Se l'endpoint non esiste nel profilo corrente, questo cmdlet lo crea. Dopo aver aggiunto un endpoint, passare il risultato al cmdlet Set-AzureTrafficManagerProfile usando l'operatore pipeline. Questo cmdlet si connette ad Azure per salvare le modifiche.

Esempio

Esempio 1: Aggiornare un endpoint per un profilo

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Set-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "ContosoApp02.cloudapp.net" -Status "Enabled" -Type "CloudService" -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

Il primo comando usa il cmdlet Get-AzureTrafficManagerProfile per ottenere il profilo denominato ContosoProfile e quindi lo archivia nella variabile $TrafficManagerProfile.

Il secondo comando aggiorna l'endpoint nel profilo di Gestione traffico archiviato in $TrafficManagerProfile. L'endpoint ha il nome di dominio ContosoApp02.cloudapp.net. Il comando specifica anche lo stato, il tipo, il peso e la posizione dell'endpoint. Il comando passa il profilo modificato al cmdlet Set-AzureTrafficManagerProfile per connettersi ad Azure per salvare le modifiche.

Parametri

-DomainName

Specifica il nome di dominio dell'endpoint da modificare.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Location

Specifica il percorso dell'endpoint aggiunto dal cmdlet. Deve trattarsi di una posizione di Azure.

Questo parametro deve contenere un valore per gli endpoint di tipo "Any" o di tipo "TrafficManager" in un profilo con il metodo di bilanciamento del carico impostato su "Prestazioni". I valori possibili sono i nomi delle aree di Azure, come indicato in https://azure.microsoft.com/regions/https://azure.microsoft.com/regions/.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MinChildEndpoints

Specifica il numero minimo di endpoint che il profilo annidato deve avere online affinché questo endpoint venga considerato online.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Status

Specifica lo stato dell'endpoint di monitoraggio. I valori validi sono:

  • Attivata
  • Disabilitata

Se si specifica il valore Enabled, Gestione traffico monitora l'endpoint e il metodo di bilanciamento del carico lo considera durante la gestione del traffico.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TrafficManagerProfile

Specifica l'oggetto profilo Gestione traffico per il quale modificare l'endpoint.

Tipo:IProfileWithDefinition
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Type

Specifica il tipo di endpoint. I valori validi sono:

  • CloudService

  • AzureWebsite

  • Gestione traffico

  • Any

Se sono presenti più endpoint AzureWebsite, gli endpoint devono trovarsi in data center diversi.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Weight

Specifica il peso dell'endpoint aggiunto dal cmdlet. L'intervallo di valori valido per questo parametro è [1.1000].

Questo parametro viene usato solo per i criteri di bilanciamento del carico RoundRobin.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition

Questo cmdlet genera un oggetto profilo Gestione traffico che contiene informazioni sul profilo aggiornato.