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 Service Management-API's. Zie de Az PowerShell-module voor cmdlets voor het beheren van Azure Resource Manager-resources.

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

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProbe

Geeft aan dat deze cmdlet gebruikmaakt van de standaardtestinstelling.

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

-IdleTimeoutInMinutes

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

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

-InformationAction

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

De acceptabele waarden voor deze parameter zijn:

  • Doorgaan
  • Negeren
  • Informeren
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

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

-InternalLoadBalancerName

Hiermee geeft u de naam van de interne load balancer.

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

-LBSetName

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

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

-Name

Hiermee geeft u een naam voor het eindpunt.

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

-NoProbe

Geeft aan dat deze cmdlet de testinstelling niet gebruikt.

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

-ProbeIntervalInSeconds

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

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

-ProbePath

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

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

-ProbePort

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

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

-ProbeProtocol

Hiermee geeft u het poortprotocol. Geldige waarden zijn:

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

-ProbeTimeoutInSeconds

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

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

-Protocol

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

  • tcp
  • Udp
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

Hiermee geeft u de virtuele machine waartoe het eindpunt behoort.

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

Uitvoerwaarden

Object