Freigeben über

Add-AzureEndpoint

  • Referenz
Modul:
Azure

Fügt einem virtuellen Computer einen Endpunkt hinzu.

Hinweis

Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service Manager (ASM)-APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   [-NoProbe]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   [-DefaultProbe]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   -ProbePort <Int32>
   -ProbeProtocol <String>
   [-ProbePath <String>]
   [-ProbeIntervalInSeconds <Int32>]
   [-ProbeTimeoutInSeconds <Int32>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Add-AzureEndpoint-Cmdlet fügt einem Virtuellen Azure-Computerobjekt einen Endpunkt hinzu.

Beispiele

Beispiel 1: Hinzufügen eines Endpunkts

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 | Update-AzureVM

Mit diesem Befehl wird die Konfiguration eines virtuellen Computers namens VirtualMachine01 mithilfe des Cmdlets "Get-AzureVM " abgerufen. Der Befehl übergibt ihn mithilfe des Pipelineoperators an das aktuelle Cmdlet. Dieses Cmdlet fügt einen Endpunkt namens "HttpIn" hinzu. Der Endpunkt verfügt über einen öffentlichen Port 80 und einen lokalen Port 8080. Der Befehl übergibt das Objekt des virtuellen Computers an das Update-AzureVM-Cmdlet , das Ihre Änderungen implementiert.

Beispiel 2: Hinzufügen eines Endpunkts, der zu einer Lastenausgleichsgruppe gehört

PS C:\> Get-AzureVM -ServiceName "LoadBalancedService" -Name "VirtualMachine12" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 -LBSetName "WebFarm" -ProbePort 80 -ProbeProtocol "http" -ProbePath '/' | Update-AzureVM

Mit diesem Befehl wird die Konfiguration eines virtuellen Computers namens VirtualMachine07 abgerufen. Das aktuelle Cmdlet fügt einen Endpunkt namens "HttpIn" hinzu. Der Endpunkt verfügt über einen öffentlichen Port 80 und einen lokalen Port 8080. Der Endpunkt gehört zur freigegebenen Lastenausgleichsgruppe mit dem Namen "WebFarm". Ein HTTP-Prüfpunkt auf Port 80 mit einem Pfad von "/" überwacht die Verfügbarkeit des Endpunkts. Der Befehl implementiert Ihre Änderungen.

Beispiel 3: Zuordnen einer virtuellen IP zu einem Endpunkt

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine25" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -LocalPort 8080 -PublicPort 80 -VirtualIPName "ContosoVip11" | Update-AzureVM

Mit diesem Befehl wird die Konfiguration eines virtuellen Computers namens VirtualMachine25 abgerufen. Das aktuelle Cmdlet fügt einen Endpunkt namens "HttpIn" hinzu. Der Endpunkt verfügt über einen öffentlichen Port 80 und einen lokalen Port 8080. Dieser Befehl ordnet dem Endpunkt eine virtuelle IP zu. Der Befehl implementiert Ihre Änderungen.

Parameter

-ACL

Gibt ein ACL-Konfigurationsobjekt (Access Control List) für den Endpunkt an.

Typ:NetworkAclObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProbe

Gibt an, dass dieses Cmdlet die Standardeinstellung des Prüfpunkts verwendet.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DirectServerReturn

Gibt an, ob dieses Cmdlet die direkte Serverrückgabe ermöglicht. Geben Sie $True an, die aktiviert werden sollen, oder $False, die deaktiviert werden sollen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IdleTimeoutInMinutes

Gibt den TCP-Leerlauf-Timeoutzeitraum in Minuten für den Endpunkt an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Weiter
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InternalLoadBalancerName

Gibt den Namen des internen Lastenausgleichs an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LBSetName

Gibt den Namen des Lastenausgleichssatzes für den Endpunkt an.

Typ:String
Aliase:LoadBalancedEndpointSetName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LoadBalancerDistribution

Gibt den Lastenausgleichsverteilungsalgorithmus an. Gültige Werte sind:

  • sourceIP. Eine zwei Tupelaffinität: Quell-IP, Ziel-IP
  • sourceIPProtocol. Eine drei Tupelaffinität: Quell-IP, Ziel-IP, Protokoll
  • nichts. Eine fünf Tupelaffinität: Quell-IP, Quellport, Ziel-IP, Zielport, Zielport, Protokoll

Der Standardwert ist keine.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LocalPort

Gibt den lokalen, privaten Port an, den dieser Endpunkt verwendet. Anwendungen innerhalb des virtuellen Computers überwachen diesen Port auf Diensteingabeanforderungen für diesen Endpunkt.

Typ:Int32
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen für den Endpunkt an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoProbe

Gibt an, dass dieses Cmdlet die Einstellung "Keine Probe" verwendet.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProbeIntervalInSeconds

Gibt das Prüfpunktabfragungsintervall in Sekunden für den Endpunkt an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProbePath

Gibt den relativen Pfad zum HTTP-Prüfpunkt an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProbePort

Gibt den port an, den der Endpunkt verwendet.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProbeProtocol

Gibt das Portprotokoll an. Gültige Werte sind:

  • tcp
  • http
Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProbeTimeoutInSeconds

Gibt den Timeoutzeitraum der Probeabfragung in Sekunden an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Protocol

Gibt das Protokoll des Endpunkts an. Gültige Werte sind:

  • tcp
  • udp
Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicPort

Gibt den öffentlichen Port an, den der Endpunkt verwendet. Wenn Sie keinen Wert angeben, weist Azure einen verfügbaren Port zu.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualIPName

Gibt den Namen einer virtuellen IP-Adresse an, die Azure dem Endpunkt zuordnet. Ihr Dienst kann mehrere virtuelle IPs haben. Verwenden Sie das Add-AzureVirtualIP-Cmdlet , um virtuelle IPs zu erstellen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VM

Gibt den virtuellen Computer an, zu dem der Endpunkt gehört.

Typ:IPersistentVM
Aliase:InputObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

Object