Condividi tramite

New-AzureRmTrafficManagerProfile

  • Riferimento
Modulo:
AzureRM.TrafficManager

Crea un 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-AzureRmTrafficManagerProfile
   -Name <String>
   -ResourceGroupName <String>
   [-ProfileStatus <String>]
   -RelativeDnsName <String>
   -Ttl <UInt32>
   -TrafficRoutingMethod <String>
   -MonitorProtocol <String>
   -MonitorPort <UInt32>
   [-MonitorPath <String>]
   [-MonitorIntervalInSeconds <Int32>]
   [-MonitorTimeoutInSeconds <Int32>]
   [-MonitorToleratedNumberOfFailures <Int32>]
   [-MaxReturn <Int64>]
   [-Tag <Hashtable>]
   [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
   [-ExpectedStatusCodeRange <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerExpectedStatusCodeRange]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzureRmTrafficManagerProfile crea un profilo Gestione traffico di Azure. Specificare il parametro Name e le impostazioni necessarie. Questo cmdlet restituisce un oggetto locale che rappresenta il nuovo profilo.

Questo cmdlet non configura Gestione traffico endpoint. È possibile aggiornare l'oggetto profilo locale usando il cmdlet Add-AzureRmTrafficManagerEndpointConfig. Caricare quindi le modifiche in Gestione traffico usando il cmdlet Set-AzureRmTrafficManagerProfile. In alternativa, è possibile aggiungere endpoint usando il cmdlet New-AzureRmTrafficManagerEndpoint.

Esempio

Esempio 1: Creare un profilo

PS C:\>New-AzureRmTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11" -ProfileStatus Enabled -TrafficRoutingMethod Performance -RelativeDnsName "contosoapp" -TTL 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/default.aspx"

Questo comando crea un profilo di Gestione traffico di Azure denominato ContosoProfile nel gruppo di risorse ResourceGroup11. Il nome di dominio completo DNS è contosoapp.trafficmanager.net.

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

-ExpectedStatusCodeRange

Elenco degli intervalli di codici di stato HTTP previsti per le richieste probe.

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

-MaxReturn

Numero massimo di risposte restituite per i profili con un metodo di routing MultiValue.

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

-MonitorIntervalInSeconds

Intervallo (in secondi) in cui Gestione traffico verificherà l'integrità di ogni endpoint in questo profilo. Il valore predefinito è 30.

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

-MonitorPath

Specifica il percorso utilizzato per monitorare l'integrità dell'endpoint. Specificare un valore relativo al nome di dominio dell'endpoint. Questo valore deve iniziare con una barra (/).

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

-MonitorPort

Specifica la porta TCP utilizzata per monitorare l'integrità dell'endpoint. I valori validi sono numeri interi compresi tra 1 e 65535.

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

-MonitorProtocol

Indica il protocollo da usare per monitorare lo stato di integrità dell'endpoint. I valori validi sono:

  • HTTP
  • HTTPS
Tipo:String
Alias:ProtocolForMonitor
Valori accettati:HTTP, HTTPS, TCP
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MonitorTimeoutInSeconds

Tempo (in secondi) che Gestione traffico consente agli endpoint in questo profilo di rispondere al controllo integrità. L'impostazione predefinita è 10.

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

-MonitorToleratedNumberOfFailures

Numero di controlli di integrità consecutivi non riusciti che Gestione traffico tollera prima di dichiarare un endpoint in questo profilo danneggiato dopo il successivo controllo di integrità consecutivo non riuscito. Il valore predefinito è 3.

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

-Name

Specifica un nome per il profilo 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

-ProfileStatus

Specifica lo stato del profilo. I valori validi sono: Abilitato e Disabilitato.

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

-RelativeDnsName

Specifica il nome DNS relativo fornito da questo profilo Gestione traffico. Gestione traffico combina questo valore e il nome di dominio DNS usato Gestione traffico di Azure per formare il nome di dominio completo (FQDN) del profilo.

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 profilo 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

-Tag

Coppie chiave-valore sotto forma di tabella hash impostata come tag nel server. Ad esempio:

@{key0="value0"; key1=$null; key2="value2"}

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

-TrafficRoutingMethod

Specifica il metodo di routing del traffico. Questo metodo determina quale endpoint Gestione traffico restituisce in risposta alle query DNS in ingresso. I valori validi sono:

  • Prestazioni
  • Ponderato
  • Priorità
  • Geografico
Tipo:String
Valori accettati:Performance, Weighted, Priority, Geographic
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Ttl

Specifica il valore TTL (Time to Live) DNS.

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

Input

None

Questo cmdlet non accetta alcun input.

Output

Microsoft.Azure.Commands.Network.TrafficManagerProfile

Questo cmdlet restituisce un nuovo oggetto TrafficManagerProfile.