Add-AzureEndpoint

  • Referenz
Modul:
Azure

Fügt einem virtuellen Computer einen Endpunkt hinzu.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

Type:NetworkAclObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProbe

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortfahren
  • Ignorieren
  • Fragen
  • SilentlyContinue
  • Beenden
  • Angehalten
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Gibt eine Informationsvariable an.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InternalLoadBalancerName

Gibt den Namen des internen Lastenausgleichs an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LBSetName

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

Type:String
Aliases:LoadBalancedEndpointSetName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt einen Namen für den Endpunkt an.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoProbe

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ProbeIntervalInSeconds

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProbePath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProbePort

Gibt den port an, den der Endpunkt verwendet.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ProbeProtocol

Gibt das Portprotokoll an. Gültige Werte sind:

  • tcp
  • http
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ProbeTimeoutInSeconds

Gibt den Timeoutzeitraum der Probeabfragung in Sekunden an.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

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

  • tcp
  • udp
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicPort

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

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

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Ausgaben

Object