Add-AzureRmTrafficManagerEndpointConfig
Aggiunge un endpoint a un oggetto profilo Gestione traffico locale.
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
Add-AzureRmTrafficManagerEndpointConfig
-EndpointName <String>
-TrafficManagerProfile <TrafficManagerProfile>
-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 Add-AzureRmTrafficManagerEndpointConfig aggiunge un endpoint a un oggetto profilo Gestione traffico di Azure locale. È possibile ottenere un profilo usando i cmdlet New-AzureRmTrafficManagerProfile o Get-AzureRmTrafficManagerProfile.
Questo cmdlet opera sull'oggetto profilo locale. Eseguire il commit delle modifiche al profilo per Gestione traffico usando il cmdlet Set-AzureRmTrafficManagerProfile. Per creare un endpoint ed eseguire il commit della modifica in una singola operazione, usare il cmdlet New-AzureRmTrafficManagerEndpoint.
Esempio
Esempio 1: Aggiungere un endpoint a un profilo
PS C:\>$TrafficManagerProfile = Get-AzureRmTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
PS C:\> Add-AzureRmTrafficManagerEndpointConfig -EndpointName "contoso" -EndpointStatus Enabled -Target "www.contoso.com" -TrafficManagerProfile $TrafficManagerProfile -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Weight 10
PS C:\> Set-AzureRmTrafficManagerProfile -TrafficManagerProfile $TrafficManagerProfile
Il primo comando ottiene un profilo Gestione traffico di Azure usando il cmdlet Get-AzureRmTrafficManagerProfile. 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
-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 |
-EndpointName
Specifica il nome dell'endpoint 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:
- 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
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 |
-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 |
-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 , usare il cmdlet Get-AzureRmTrafficManagerProfile.
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 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
Microsoft.Azure.Commands.Network.TrafficManagerProfile
Questo cmdlet accetta un oggetto TrafficManagerProfile per questo cmdlet.
Output
Microsoft.Azure.Commands.Network.TrafficManagerProfile
Questo cmdlet restituisce un oggetto TrafficManagerProfile modificato.