Condividi tramite

New-AzureRmTrafficManagerEndpoint

  • Riferimento
Modulo:
AzureRM.TrafficManager

Crea un endpoint nel profilo di Gestione traffico.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

New-AzureRmTrafficManagerEndpoint
   -Name <String>
   -ProfileName <String>
   -ResourceGroupName <String>
   -Type <String>
   [-TargetResourceId <String>]
   [-Target <String>]
   -EndpointStatus <String>
   [-Weight <UInt32>]
   [-Priority <UInt32>]
   [-EndpointLocation <String>]
   [-MinChildEndpoints <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 New-AzureRmTrafficManagerEndpoint crea un endpoint in un profilo di Gestione traffico di Azure.

Questo cmdlet esegue il commit di ogni nuovo endpoint nel servizio Gestione traffico. Per aggiungere più endpoint a un oggetto profilo Gestione traffico locale ed eseguire il commit delle modifiche in una singola operazione, usare il cmdlet Add-AzureRmTrafficManagerEndpointConfig.

Esempio

Esempio 1: Creare un endpoint esterno per un profilo

PS C:\>New-AzureRmTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Target "www.contoso.com" -Weight 10

Questo comando crea un endpoint esterno denominato contoso nel profilo denominato ContosoProfile nel gruppo di risorse denominato ResourceGroup11.

Esempio 2: Creare un endpoint di Azure per un profilo

PS C:\>New-AzureRmTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type AzureEndpoints -Priority 1 -TargetResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Default-Web-CentralUS/providers/Microsoft.Web/sites/contoso-web-app" -Weight 10

Questo comando crea un endpoint di Azure denominato contoso nel profilo denominato ContosoProfile nel gruppo di risorse ResouceGroup11. L'endpoint di Azure punta all'app Web di Azure il cui ID di Azure Resource Manager viene assegnato dal percorso URI in TargetResourceId. Il comando non specifica il parametro EndpointLocation perché la risorsa dell'app Web fornisce il percorso.

Parametri

-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: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 dihttps://azure.microsoft.com/regions/ Azure (https://azure.microsoft.com/regions/).

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

-EndpointStatus

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

  • Attivata
  • Disabilitata

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'. Per un elenco completo dei valori accettati, consultare Gestione traffico documentazione.

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

-MinChildEndpoints

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

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

-Name

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

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

-Priority

Specifica la priorità assegnata 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

-ProfileName

Specifica il nome di un profilo di Gestione traffico a cui questo cmdlet aggiunge un endpoint. Per ottenere un profilo, usare i cmdlet New-AzureRmTrafficManagerProfile o Get-AzureRmTrafficManagerProfile.

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

-ResourceGroupName

Specifica il nome di un gruppo di risorse. Questo cmdlet crea un endpoint Gestione traffico nel gruppo specificato da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
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

-Type

Specifica il tipo di endpoint aggiunto da questo cmdlet al profilo di Gestione traffico. 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 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

None

Questo cmdlet non accetta alcun input.

Output

TrafficManagerEndpoint