Freigeben über

Set-AzureEndpoint

  • Referenz
Modul:
Azure

Ändert einen Endpunkt, der einem virtuellen Computer zugewiesen ist.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-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

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

Beschreibung

Das Cmdlet Set-AzureEndpoint ändert einen Endpunkt, der einem virtuellen Azure-Computer zugewiesen ist. Sie können Änderungen an einem Endpunkt angeben, der nicht lastenausgleichsgeglichen ist.

Beispiele

Beispiel 1: Ändern eines Endpunkts zum Überwachen eines Ports

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Set-AzureEndpoint -Name "Web" -PublicPort 443 -LocalPort 443 -Protocol tcp | 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. Mit diesem Cmdlet wird der Endpunkt namens "Web" geändert, um auf Port 443 zu lauschen. Der Befehl übergibt das Objekt des virtuellen Computers an das Update-AzureVM-Cmdlet , das Ihre Änderungen implementiert.

Parameter

-ACL

Gibt ein ACL-Konfigurationsobjekt (Access Control List) an, das dieses Cmdlet für den Endpunkt anwendet.

Typ:NetworkAclObject
Position:Named
Standardwert:None
Erforderlich:False
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:

  • Fortsetzen
  • 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

-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:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des Endpunkts an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
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:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicPort

Gibt den öffentlichen Port an, den der Endpunkt verwendet.

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