Delen via

Add-AzureEndpoint

  • Referentie
Module:
Azure

Hiermee voegt u een eindpunt toe aan een virtuele machine.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Description

Met de cmdlet Add-AzureEndpoint wordt een eindpunt toegevoegd aan een azure-object voor virtuele machines.

Voorbeelden

Voorbeeld 1: Een eindpunt toevoegen

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

Met deze opdracht wordt de configuratie van een virtuele machine met de naam VirtualMachine01 opgehaald met behulp van de Get-AzureVM-cmdlet . De opdracht geeft deze door aan de huidige cmdlet met behulp van de pijplijnoperator. Met deze cmdlet wordt een eindpunt met de naam HttpIn toegevoegd. Het eindpunt heeft een openbare poort 80 en lokale poort 8080. Met de opdracht wordt het object van de virtuele machine doorgegeven aan de cmdlet Update-AzureVM , waarmee uw wijzigingen worden geïmplementeerd.

Voorbeeld 2: Een eindpunt toevoegen dat deel uitmaakt van een groep met gelijke taakverdeling

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

Met deze opdracht wordt de configuratie opgehaald van een virtuele machine met de naam VirtualMachine07. Met de huidige cmdlet wordt een eindpunt met de naam HttpIn toegevoegd. Het eindpunt heeft een openbare poort 80 en lokale poort 8080. Het eindpunt behoort tot de gedeelde groep met gelijke taakverdeling met de naam WebFarm. Een HTTP-test op poort 80 met een pad van '/' bewaakt de beschikbaarheid van het eindpunt. Met de opdracht worden uw wijzigingen geïmplementeerd.

Voorbeeld 3: Een virtueel IP-adres koppelen aan een eindpunt

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

Met deze opdracht wordt de configuratie opgehaald van een virtuele machine met de naam VirtualMachine25. Met de huidige cmdlet wordt een eindpunt met de naam HttpIn toegevoegd. Het eindpunt heeft een openbare poort 80 en lokale poort 8080. Met deze opdracht wordt een virtueel IP-adres aan het eindpunt gekoppeld. Met de opdracht worden uw wijzigingen geïmplementeerd.

Parameters

-ACL

Hiermee geeft u een ACL-configuratieobject (Access Control List) voor het eindpunt op.

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

-DefaultProbe

Geeft aan dat deze cmdlet gebruikmaakt van de standaardtestinstelling.

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

-DirectServerReturn

Hiermee geeft u op of met deze cmdlet direct server return wordt ingeschakeld. Geef $True op die u wilt inschakelen of $False om uit te schakelen.

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

-IdleTimeoutInMinutes

Hiermee geeft u de time-outperiode voor TCP inactief, in minuten, voor het eindpunt.

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

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliassen:infa
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

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

-InternalLoadBalancerName

Hiermee geeft u de naam van de interne load balancer.

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

-LBSetName

Hiermee geeft u de naam op van de load balancer die is ingesteld voor het eindpunt.

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

-LoadBalancerDistribution

Hiermee geeft u het distributie-algoritme van de load balancer op. Geldige waarden zijn:

  • sourceIP. Een twee tupleaffiniteit: bron-IP, doel-IP
  • sourceIPProtocol. Een drie tupleaffiniteit: bron-IP, doel-IP, protocol
  • geen. Een vijf tupleaffiniteit: bron-IP, bronpoort, doel-IP, doelpoort, protocol

De standaardwaarde is geen.

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

-LocalPort

Hiermee geeft u de lokale, privépoort die door dit eindpunt wordt gebruikt. Toepassingen binnen de virtuele machine luisteren op deze poort voor service-invoeraanvragen voor dit eindpunt.

Type:Int32
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een naam voor het eindpunt.

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

-NoProbe

Geeft aan dat deze cmdlet de testinstelling niet gebruikt.

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

-ProbeIntervalInSeconds

Hiermee geeft u het polling-interval voor de test, in seconden, voor het eindpunt.

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

-ProbePath

Hiermee geeft u het relatieve pad naar de HTTP-test.

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

-ProbePort

Hiermee geeft u de poort op die door het eindpunt wordt gebruikt.

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

-ProbeProtocol

Hiermee geeft u het poortprotocol. Geldige waarden zijn:

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

-ProbeTimeoutInSeconds

Hiermee geeft u de time-outperiode voor de polling van de test op in seconden.

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

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

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

-Protocol

Hiermee geeft u het protocol van het eindpunt. Geldige waarden zijn:

  • tcp
  • Udp
Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublicPort

Hiermee geeft u de openbare poort op die door het eindpunt wordt gebruikt. Als u geen waarde opgeeft, wijst Azure een beschikbare poort toe.

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

-VirtualIPName

Hiermee geeft u de naam op van een virtueel IP-adres dat Azure aan het eindpunt koppelt. Uw service kan meerdere virtuele IP-adressen hebben. Gebruik de cmdlet Add-AzureVirtualIP om virtuele IP-adressen te maken.

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

-VM

Hiermee geeft u de virtuele machine waartoe het eindpunt behoort.

Type:IPersistentVM
Aliassen:InputObject
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

Object