Delen via

Add-AzTrafficManagerEndpointConfig

  • Referentie
Module:
Az.TrafficManager

Hiermee voegt u een eindpunt toe aan een lokaal Traffic Manager-profielobject.

Syntaxis

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

Description

De cmdlet Add-AzTrafficManagerEndpointConfig voegt een eindpunt toe aan een lokaal Azure Traffic Manager-profielobject. U kunt een profiel ophalen met behulp van de New-AzTrafficManagerProfile- of Get-AzTrafficManagerProfile-cmdlets.

Deze cmdlet werkt op het lokale profielobject. Voer uw wijzigingen door in het profiel voor Traffic Manager met behulp van de cmdlet Set-AzTrafficManagerProfile. Als u een eindpunt wilt maken en de wijziging in één bewerking wilt doorvoeren, gebruikt u de cmdlet New-AzTrafficManagerEndpoint.

Voorbeelden

Voorbeeld 1: Een eindpunt toevoegen aan een profiel

$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

De eerste opdracht haalt een Azure Traffic Manager-profiel op met behulp van de cmdlet Get-AzTrafficManagerProfile. Met de opdracht wordt het lokale profiel opgeslagen in de variabele $TrafficManagerProfile.

Met de tweede opdracht wordt een eindpunt met de naam contoso toegevoegd aan het profiel dat is opgeslagen in $TrafficManagerProfile. De opdracht bevat configuratiegegevens voor het eindpunt. Met deze opdracht wordt alleen het lokale object gewijzigd.

Met de laatste opdracht wordt het Traffic Manager-profiel in Azure bijgewerkt zodat het overeenkomt met de lokale waarde in $TrafficManagerProfile.

Parameters

-AlwaysServe

Als Always Serve is ingeschakeld, wordt testen op eindpuntstatus uitgeschakeld en worden eindpunten opgenomen in de verkeersrouteringsmethode.

Type:String
Geaccepteerde waarden:Enabled, Disabled
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CustomHeader

Lijst met aangepaste headernaam- en waardeparen voor testaanvragen.

Type:List<T>[TrafficManagerCustomHeader]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EndpointLocation

Hiermee geeft u de locatie op van het eindpunt dat moet worden gebruikt in de routeringsmethode voor prestatieverkeer. Deze parameter is alleen van toepassing op eindpunten van het type ExternalEndpoints of het type NestedEndpoints. U moet deze parameter opgeven wanneer de routeringsmethode prestatieverkeer wordt gebruikt.

Geef een Azure-regionaam op. Zie Azure-regio'shttp://azure.microsoft.com/regions/ (http://azure.microsoft.com/regions/) voor een volledige lijst met Azure-regio's.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EndpointName

Hiermee geeft u de naam op van het Traffic Manager-eindpunt dat door deze cmdlet wordt toegevoegd.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EndpointStatus

Hiermee geeft u de status van het eindpunt. Geldige waarden zijn:

  • Ingeschakeld
  • Invalide

Als de status is ingeschakeld, wordt het eindpunt gecontroleerd op de eindpuntstatus en wordt het opgenomen in de verkeersrouteringsmethode.

Type:String
Geaccepteerde waarden:Enabled, Disabled
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-GeoMapping

De lijst met regio's die aan dit eindpunt zijn toegewezen bij het gebruik van de routeringsmethode 'Geografisch'. Raadpleeg de Documentatie van Traffic Manager voor een volledige lijst met geaccepteerde waarden.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinChildEndpoints

Het minimale aantal eindpunten dat beschikbaar moet zijn in het onderliggende profiel, zodat het geneste eindpunt in het bovenliggende profiel als beschikbaar moet worden beschouwd. Alleen van toepassing op eindpunt van het type NestedEndpoints.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinChildEndpointsIPv4

Het minimale aantal IPv4-eindpunten (DNS-recordtype A) dat beschikbaar moet zijn in het onderliggende profiel, zodat het geneste eindpunt in het bovenliggende profiel als beschikbaar moet worden beschouwd. Alleen van toepassing op eindpunt van het type NestedEndpoints.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinChildEndpointsIPv6

Het minimale aantal IPv6-eindpunten (DNS-recordtype AAAA) dat beschikbaar moet zijn in het onderliggende profiel, zodat het geneste eindpunt in het bovenliggende profiel als beschikbaar kan worden beschouwd. Alleen van toepassing op eindpunt van het type NestedEndpoints.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Priority

Hiermee geeft u de prioriteit die Traffic Manager toewijst aan het eindpunt. Deze parameter wordt alleen gebruikt als het Traffic Manager-profiel is geconfigureerd met de methode voor verkeersroutering met prioriteit. Geldige waarden zijn gehele getallen van 1 tot en met 1000. Lagere waarden vertegenwoordigen een hogere prioriteit.

Als u een prioriteit opgeeft, moet u prioriteiten opgeven voor alle eindpunten in het profiel en kunnen er geen twee eindpunten dezelfde prioriteitswaarde delen. Als u geen prioriteiten opgeeft, wijst Traffic Manager standaardprioriteitswaarden toe aan de eindpunten, te beginnen met één (1), in de volgorde waarin het profiel de eindpunten vermeldt.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SubnetMapping

De lijst met adresbereiken of subnetten die aan dit eindpunt zijn toegewezen bij gebruik van de verkeersrouteringsmethode 'Subnet'.

Type:List<T>[TrafficManagerIpAddressRange]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Target

Hiermee geeft u de volledig gekwalificeerde DNS-naam van het eindpunt. Traffic Manager retourneert deze waarde in DNS-antwoorden wanneer verkeer naar dit eindpunt wordt doorgestuurd. Geef deze parameter alleen op voor het eindpunttype ExternalEndpoints. Geef voor andere eindpunttypen in plaats daarvan de parameter TargetResourceId op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TargetResourceId

Hiermee geeft u de resource-id van het doel. Geef deze parameter alleen op voor de eindpunttypen AzureEndpoints en NestedEndpoints. Geef voor het eindpunttype ExternalEndpoints de parameter Target op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TrafficManagerProfile

Hiermee geeft u een lokale TrafficManagerProfile object. Met deze cmdlet wordt dit lokale object gewijzigd. Als u een TrafficManagerProfile--object wilt verkrijgen, gebruikt u de cmdlet Get-AzTrafficManagerProfile.

Type:TrafficManagerProfile
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Type

Hiermee geeft u het type eindpunt op dat met deze cmdlet wordt toegevoegd aan het Azure Traffic Manager-profiel. Geldige waarden zijn:

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints
Type:String
Geaccepteerde waarden:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Weight

Hiermee geeft u het gewicht op dat Traffic Manager aan het eindpunt toewijst. Geldige waarden zijn gehele getallen van 1 tot en met 1000. De standaardwaarde is één (1). Deze parameter wordt alleen gebruikt als het Traffic Manager-profiel is geconfigureerd met de gewogen verkeersrouteringsmethode.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

TrafficManagerProfile

Uitvoerwaarden

TrafficManagerProfile