Add-AzTrafficManagerEndpointConfig
Fügt einem lokalen Traffic Manager-Profilobjekt einen Endpunkt hinzu.
Syntax
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>]
Beschreibung
Das Add-AzTrafficManagerEndpointConfig-Cmdlet fügt einem lokalen Azure Traffic Manager-Profilobjekt einen Endpunkt hinzu. Sie können ein Profil mithilfe der Cmdlets New-AzTrafficManagerProfile oder Get-AzTrafficManagerProfile abrufen.
Dieses Cmdlet wird für das lokale Profilobjekt ausgeführt. Führen Sie mithilfe des Cmdlets Set-AzTrafficManagerProfile einen Commit für die Änderungen am Profil für Traffic Manager durch. Verwenden Sie das Cmdlet New-AzTrafficManagerEndpoint, um einen Endpunkt zu erstellen und die Änderung in einem einzigen Vorgang zu übernehmen.
Beispiele
Beispiel 1: Hinzufügen eines Endpunkts zu einem Profil
$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
Der erste Befehl ruft ein Azure Traffic Manager-Profil mithilfe des Cmdlets "Get-AzTrafficManagerProfile " ab. Der Befehl speichert das lokale Profil in der variablen $TrafficManagerProfile.
Der zweite Befehl fügt dem in $TrafficManagerProfile gespeicherten Profil einen Endpunkt namens "contoso" hinzu. Der Befehl enthält Konfigurationsdaten für den Endpunkt. Dieser Befehl ändert nur das lokale Objekt.
Der letzte Befehl aktualisiert das Traffic Manager-Profil in Azure so, dass er mit dem lokalen Wert in $TrafficManagerProfile übereinstimmt.
Parameter
-AlwaysServe
Wenn Always Serve aktiviert ist, wird die Ermittlung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode einbezogen.
Typ: | String |
Zulässige Werte: | Enabled, Disabled |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomHeader
Liste der benutzerdefinierten Headernamen- und Wertpaare für Prüfpunktanforderungen.
Typ: | List<T>[TrafficManagerCustomHeader] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EndpointLocation
Gibt den Speicherort des Endpunkts an, der in der Performance-Datenverkehrsroutingmethode verwendet werden soll. Dieser Parameter gilt nur für Endpunkte des Typs "ExternalEndpoints" oder "NestedEndpoints". Sie müssen diesen Parameter angeben, wenn die Performance-Datenverkehrsroutingmethode verwendet wird.
Geben Sie einen Azure-Regionsnamen an. Eine vollständige Liste der Azure-Regionen finden Sie unter Azure-Regionenhttp://azure.microsoft.com/regions/ (http://azure.microsoft.com/regions/).
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EndpointName
Gibt den Namen des Traffic Manager-Endpunkts an, den dieses Cmdlet hinzufügt.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EndpointStatus
Gibt den Status des Endpunkts an. Gültige Werte sind:
- Aktiviert
- Disabled
Wenn der Status "Aktiviert" ist, wird der Endpunkt auf die Endpunktintegrität untersucht und in der Datenverkehrsroutingmethode enthalten.
Typ: | String |
Zulässige Werte: | Enabled, Disabled |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GeoMapping
Die Liste der Regionen, die diesem Endpunkt zugeordnet sind, wenn die Routingmethode "Geografischer Datenverkehr" verwendet wird. Eine vollständige Liste der akzeptierten Werte finden Sie in der Traffic Manager-Dokumentation.
Typ: | List<T>[String] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinChildEndpoints
Die Mindestanzahl der Endpunkte, die im untergeordneten Profil verfügbar sein müssen, damit der geschachtelte Endpunkt im übergeordneten Profil als verfügbar betrachtet werden kann. Gilt nur für den Endpunkt vom Typ 'NestedEndpoints'.
Typ: | Nullable<T>[UInt32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinChildEndpointsIPv4
Die Mindestanzahl der IPv4-Endpunkte (DNS-Eintragstyp A), die im untergeordneten Profil verfügbar sein müssen, damit der geschachtelte Endpunkt im übergeordneten Profil als verfügbar betrachtet wird. Gilt nur für den Endpunkt vom Typ 'NestedEndpoints'.
Typ: | Nullable<T>[UInt32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinChildEndpointsIPv6
Die Mindestanzahl der IPv6-Endpunkte (DNS-Eintragstyp AAAA), die im untergeordneten Profil verfügbar sein müssen, damit der geschachtelte Endpunkt im übergeordneten Profil als verfügbar betrachtet wird. Gilt nur für den Endpunkt vom Typ 'NestedEndpoints'.
Typ: | Nullable<T>[UInt32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Priority
Gibt die Priorität an, die Der Datenverkehrs-Manager dem Endpunkt zuweist. Dieser Parameter wird nur verwendet, wenn das Datenverkehrs-Manager-Profil mit der für die Priorität-Datenverkehrsroutingmethode konfiguriert ist. Gültige Werte sind ganze Zahlen zwischen 1 und 1000. Niedrigere Werte stellen eine höhere Priorität dar.
Wenn Sie eine Priorität angeben, müssen Sie Prioritäten für alle Endpunkte im Profil angeben, und keine zwei Endpunkte können denselben Prioritätswert gemeinsam nutzen. Wenn Sie keine Prioritäten angeben, weist Traffic Manager den Endpunkten Standardwerte zu, beginnend mit einem (1), in der Reihenfolge, in der das Profil die Endpunkte auflistet.
Typ: | Nullable<T>[UInt32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubnetMapping
Die Liste der Adressbereiche oder Subnetze, die diesem Endpunkt bei Verwendung der Routingmethode "Subnetz" zugeordnet sind.
Typ: | List<T>[TrafficManagerIpAddressRange] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Target
Gibt den vollqualifizierten DNS-Namen des Endpunkts an. Der Datenverkehrs-Manager gibt diesen Wert in DNS-Antworten zurück, wenn dieser Datenverkehr an diesen Endpunkt leitet. Geben Sie diesen Parameter nur für den Endpunkttyp "ExternalEndpoints" an. Geben Sie für andere Endpunkttypen stattdessen den Parameter TargetResourceId an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetResourceId
Gibt die Ressourcen-ID des Ziels an. Geben Sie diesen Parameter nur für die Endpunkttypen AzureEndpoints und NestedEndpoints an. Geben Sie für den Endpunkttyp "ExternalEndpoints" stattdessen den Parameter "Target " an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrafficManagerProfile
Gibt ein lokales TrafficManagerProfile -Objekt an. Dieses Cmdlet ändert dieses lokale Objekt. Verwenden Sie zum Abrufen eines TrafficManagerProfile-Objekts das Cmdlet Get-AzTrafficManagerProfile.
Typ: | TrafficManagerProfile |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Type
Gibt den Endpunkttyp an, den dieses Cmdlet dem Azure Traffic Manager-Profil hinzufügt. Gültige Werte sind:
- AzureEndpoints
- ExternalEndpoints
- NestedEndpoints
Typ: | String |
Zulässige Werte: | AzureEndpoints, ExternalEndpoints, NestedEndpoints |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Weight
Gibt die Gewichtung an, die der Datenverkehrs-Manager dem Endpunkt zuweist. Gültige Werte sind ganze Zahlen zwischen 1 und 1000. Der Standardwert ist ein Wert (1). Dieser Parameter wird nur verwendet, wenn das Traffic Manager-Profil mit der Gewichteten Datenverkehrsroutingmethode konfiguriert ist.
Typ: | Nullable<T>[UInt32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |