Dela via


Add-AzureEndpoint

Lägger till en slutpunkt i en virtuell dator.

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

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

Cmdleten Add-AzureEndpoint lägger till en slutpunkt i ett virtuellt Azure-datorobjekt.

Exempel

Exempel 1: Lägg till en slutpunkt

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

Det här kommandot hämtar konfigurationen av en virtuell dator med namnet VirtualMachine01 med hjälp av cmdleten Get-AzureVM . Kommandot skickar den till den aktuella cmdleten med hjälp av pipelineoperatorn. Den här cmdleten lägger till en slutpunkt med namnet HttpIn. Slutpunkten har en offentlig port 80 och lokal port 8080. Kommandot skickar objektet för den virtuella datorn till cmdleten Update-AzureVM , som implementerar dina ändringar.

Exempel 2: Lägg till en slutpunkt som tillhör en belastningsutjämningsgrupp

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

Det här kommandot hämtar konfigurationen av en virtuell dator med namnet VirtualMachine07. Den aktuella cmdleten lägger till en slutpunkt med namnet HttpIn. Slutpunkten har en offentlig port 80 och lokal port 8080. Slutpunkten tillhör den delade lastbalanserade gruppen webfarm. En HTTP-avsökning på port 80 med sökvägen "/" övervakar slutpunktens tillgänglighet. Kommandot implementerar dina ändringar.

Exempel 3: Associera en virtuell IP-adress till en slutpunkt

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

Det här kommandot hämtar konfigurationen av en virtuell dator med namnet VirtualMachine25. Den aktuella cmdleten lägger till en slutpunkt med namnet HttpIn. Slutpunkten har en offentlig port 80 och lokal port 8080. Det här kommandot kopplar en virtuell IP-adress till slutpunkten. Kommandot implementerar dina ändringar.

Parametrar

-ACL

Anger ett konfigurationsobjekt för åtkomstkontrollistan (ACL) för slutpunkten.

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

-DefaultProbe

Anger att den här cmdleten använder standardavsökningsinställningen.

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

-DirectServerReturn

Anger om den här cmdleten aktiverar direkt serverretur. Ange $True som ska aktiveras eller $False att inaktivera.

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

-IdleTimeoutInMinutes

Anger tidsgränsen för TCP-inaktivitet i minuter för slutpunkten.

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

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De godtagbara värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Anger en informationsvariabel.

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

-InternalLoadBalancerName

Anger namnet på den interna lastbalanseraren.

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

-LBSetName

Anger namnet på lastbalanserarens uppsättning för slutpunkten.

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

-LoadBalancerDistribution

Anger algoritmen för lastbalanserarens distribution. Giltiga värden är:

  • sourceIP. En två tuppelns tillhörighet: Käll-IP, mål-IP
  • sourceIPProtocol. En tre tuppelns tillhörighet: Käll-IP, mål-IP, protokoll
  • Ingen. En fem tuppelns tillhörighet: Käll-IP, källport, mål-IP, målport, protokoll

Standardvärdet är inget.

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

-LocalPort

Anger den lokala, privata port som den här slutpunkten använder. Program på den virtuella datorn lyssnar på den här porten efter tjänstindatabegäranden för den här slutpunkten.

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

-Name

Anger ett namn för slutpunkten.

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

-NoProbe

Anger att den här cmdleten använder inställningen ingen avsökning.

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

-ProbeIntervalInSeconds

Anger avsökningsintervallet i sekunder för slutpunkten.

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

-ProbePath

Anger den relativa sökvägen till HTTP-avsökningen.

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

-ProbePort

Anger den port som slutpunkten använder.

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

-ProbeProtocol

Anger portprotokollet. Giltiga värden är:

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

-ProbeTimeoutInSeconds

Anger tidsgränsen för avsökningsavsökningen i sekunder.

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

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

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

-Protocol

Anger slutpunktens protokoll. Giltiga värden är:

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

-PublicPort

Anger den offentliga port som slutpunkten använder. Om du inte anger något värde tilldelar Azure en tillgänglig port.

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

-VirtualIPName

Anger namnet på en virtuell IP-adress som Azure associerar med slutpunkten. Tjänsten kan ha flera virtuella IP-adresser. Om du vill skapa virtuella IP-adresser använder du cmdleten Add-AzureVirtualIP .

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

-VM

Anger den virtuella dator som slutpunkten tillhör.

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

Utdata

Object