Condividi tramite


Add-AzTrafficManagerEndpointConfig

Aggiunge un endpoint a un oggetto profilo di Gestione traffico locale.

Sintassi

Add-AzTrafficManagerEndpointConfig
   -EndpointName <String>
   -TrafficManagerProfile <TrafficManagerProfile>
   -Type <String>
   [-TargetResourceId <String>]
   [-Target <String>]
   -EndpointStatus <String>
   [-Weight <UInt32>]
   [-Priority <UInt32>]
   [-EndpointLocation <String>]
   [-AlwaysServe <String>]
   [-MinChildEndpoints <UInt32>]
   [-MinChildEndpointsIPv4 <UInt32>]
   [-MinChildEndpointsIPv6 <UInt32>]
   [-GeoMapping <System.Collections.Generic.List`1[System.String]>]
   [-SubnetMapping <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerIpAddressRange]>]
   [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet add-AzTrafficManagerEndpointConfig aggiunge un endpoint a un oggetto profilo di Gestione traffico di Azure locale. È possibile ottenere un profilo usando i cmdlet New-AzTrafficManagerProfile o Get-AzTrafficManagerProfile.

Questo cmdlet opera sull'oggetto profilo locale. Eseguire il commit delle modifiche apportate al profilo per Gestione traffico usando il cmdlet Set-AzTrafficManagerProfile. Per creare un endpoint ed eseguire il commit della modifica in una singola operazione, usare il cmdlet New-AzTrafficManagerEndpoint.

Esempio

Esempio 1: Aggiungere un endpoint a un profilo

$TrafficManagerProfile = Get-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
Add-AzTrafficManagerEndpointConfig -EndpointName "contoso" -EndpointStatus Enabled -Target "www.contoso.com" -TrafficManagerProfile $TrafficManagerProfile -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Weight 10
Set-AzTrafficManagerProfile -TrafficManagerProfile $TrafficManagerProfile

Il primo comando ottiene un profilo di Gestione traffico di Azure usando il cmdlet Get-AzTrafficManagerProfile . Il comando archivia il profilo locale nella variabile $TrafficManagerProfile.

Il secondo comando aggiunge un endpoint denominato contoso al profilo archiviato in $TrafficManagerProfile. Il comando include i dati di configurazione per l'endpoint. Questo comando modifica solo l'oggetto locale.

Il comando finale aggiorna il profilo di Gestione traffico in Azure in modo che corrisponda al valore locale in $TrafficManagerProfile.

Parametri

-AlwaysServe

Se Always Serve è abilitato, il probe per l'integrità degli endpoint verrà disabilitato e gli endpoint verranno inclusi nel metodo di routing del traffico.

Tipo:String
Valori accettati:Enabled, Disabled
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CustomHeader

Elenco di coppie nome intestazione e valore personalizzate per le richieste probe.

Tipo:List<T>[TrafficManagerCustomHeader]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EndpointLocation

Specifica il percorso dell'endpoint da usare nel metodo di routing del traffico prestazioni. Questo parametro è applicabile solo agli endpoint del tipo ExternalEndpoints o NestedEndpoints. È necessario specificare questo parametro quando viene usato il metodo di routing del traffico prestazioni.

Specificare un nome di area di Azure. Per un elenco completo delle aree di Azure, vedere Aree di Azurehttp://azure.microsoft.com/regions/ (http://azure.microsoft.com/regions/).

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

-EndpointName

Specifica il nome dell'endpoint di Gestione traffico aggiunto da questo cmdlet.

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

-EndpointStatus

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

  • Abilitato
  • Disabile

Se lo stato è Abilitato, viene eseguito il probe dell'endpoint per l'integrità dell'endpoint e viene incluso nel metodo di routing del traffico.

Tipo:String
Valori accettati:Enabled, Disabled
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-GeoMapping

Elenco di aree mappate a questo endpoint quando si usa il metodo di routing del traffico 'Geographic'. Consultare la documentazione di Gestione traffico per un elenco completo dei valori accettati.

Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MinChildEndpoints

Numero minimo di endpoint che devono essere disponibili nel profilo figlio affinché l'endpoint annidato nel profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.

Tipo:Nullable<T>[UInt32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MinChildEndpointsIPv4

Numero minimo di endpoint IPv4 (tipo di record DNS A) che devono essere disponibili nel profilo figlio affinché l'endpoint annidato nel profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.

Tipo:Nullable<T>[UInt32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MinChildEndpointsIPv6

Numero minimo di endpoint IPv6 (tipo di record DNS AAAA) che devono essere disponibili nel profilo figlio affinché l'endpoint annidato nel profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.

Tipo:Nullable<T>[UInt32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Priority

Specifica la priorità assegnata da Gestione traffico all'endpoint. Questo parametro viene usato solo se il profilo di Gestione traffico è configurato con il metodo di routing del traffico Priority. I valori validi sono numeri interi compresi tra 1 e 1000. I valori inferiori rappresentano una priorità più alta.

Se si specifica una priorità, è necessario specificare le priorità in tutti gli endpoint del profilo e non è possibile condividere lo stesso valore di priorità per due endpoint. Se non si specificano le priorità, Gestione traffico assegna i valori di priorità predefiniti agli endpoint, a partire da uno (1), nell'ordine in cui il profilo elenca gli endpoint.

Tipo:Nullable<T>[UInt32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SubnetMapping

Elenco di intervalli di indirizzi o subnet mappati a questo endpoint quando si usa il metodo di routing del traffico 'Subnet'.

Tipo:List<T>[TrafficManagerIpAddressRange]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Target

Specifica il nome DNS completo dell'endpoint. Gestione traffico restituisce questo valore nelle risposte DNS quando indirizza il traffico a questo endpoint. Specificare questo parametro solo per il tipo di endpoint ExternalEndpoints. Per altri tipi di endpoint, specificare invece il parametro TargetResourceId.

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

-TargetResourceId

Specifica l'ID risorsa della destinazione. Specificare questo parametro solo per i tipi di endpoint AzureEndpoints e NestedEndpoints. Per il tipo di endpoint ExternalEndpoints, specificare invece il parametro Target.

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

-TrafficManagerProfile

Specifica un oggetto TrafficManagerProfile locale. Questo cmdlet modifica questo oggetto locale. Per ottenere un oggetto TrafficManagerProfile, utilizzare il cmdlet Get-AzTrafficManagerProfile.

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

-Type

Specifica il tipo di endpoint aggiunto da questo cmdlet al profilo di Gestione traffico di Azure. I valori validi sono:

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints
Tipo:String
Valori accettati:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Weight

Specifica il peso assegnato da Gestione traffico all'endpoint. I valori validi sono numeri interi compresi tra 1 e 1000. Il valore predefinito è uno (1). Questo parametro viene usato solo se il profilo di Gestione traffico è configurato con il metodo di routing del traffico ponderato.

Tipo:Nullable<T>[UInt32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Output