Sdílet prostřednictvím

Add-AzureEndpoint

  • Reference
Modul:
Azure

Přidá koncový bod do virtuálního počítače.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Rutina Add-AzureEndpoint přidá koncový bod do objektu virtuálního počítače Azure.

Příklady

Příklad 1: Přidání koncového bodu

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

Tento příkaz načte konfiguraci virtuálního počítače s názvem VirtualMachine01 pomocí rutiny Get-AzureVM . Příkaz ho předá aktuální rutině pomocí operátoru kanálu. Tato rutina přidá koncový bod s názvem HttpIn. Koncový bod má veřejný port 80 a místní port 8080. Příkaz předá objekt virtuálního počítače rutině Update-AzureVM , která implementuje vaše změny.

Příklad 2: Přidání koncového bodu, který patří do skupiny s vyrovnáváním zatížení

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

Tento příkaz načte konfiguraci virtuálního počítače s názvem VirtualMachine07. Aktuální rutina přidá koncový bod s názvem HttpIn. Koncový bod má veřejný port 80 a místní port 8080. Koncový bod patří do sdílené skupiny s vyrovnáváním zatížení s názvem WebFarm. Sonda HTTP na portu 80 s cestou /monitoruje dostupnost koncového bodu. Příkaz implementuje vaše změny.

Příklad 3: Přidružení virtuální IP adresy ke koncovému bodu

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

Tento příkaz načte konfiguraci virtuálního počítače s názvem VirtualMachine25. Aktuální rutina přidá koncový bod s názvem HttpIn. Koncový bod má veřejný port 80 a místní port 8080. Tento příkaz přidruží virtuální IP adresu ke koncovému bodu. Příkaz implementuje vaše změny.

Parametry

-ACL

Určuje objekt konfigurace seznamu řízení přístupu (ACL) pro koncový bod.

Typ:NetworkAclObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProbe

Označuje, že tato rutina používá výchozí nastavení sondy.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DirectServerReturn

Určuje, jestli tato rutina povolí přímé vrácení serveru. Zadejte $True, které chcete povolit, nebo $False zakázat.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IdleTimeoutInMinutes

Určuje časový limit nečinnosti protokolu TCP v minutách koncového bodu.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Tento parametr přijímá tyto hodnoty:

  • Pokračovat
  • Ignorovat
  • Informovat se
  • SilentlyContinue
  • Zastavit
  • Suspend
Typ:ActionPreference
Aliasy:infa
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InformationVariable

Určuje informační proměnnou.

Typ:String
Aliasy:iv
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InternalLoadBalancerName

Určuje název interního nástroje pro vyrovnávání zatížení.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LBSetName

Určuje název nástroje pro vyrovnávání zatížení nastavený pro koncový bod.

Typ:String
Aliasy:LoadBalancedEndpointSetName
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LoadBalancerDistribution

Určuje distribuční algoritmus nástroje pro vyrovnávání zatížení. Platné hodnoty jsou:

  • sourceIP. Spřažení se řazenou kolekcí členů: zdrojová IP adresa, cílová IP adresa
  • sourceIPProtocol. Tří spřažení řazené kolekce členů: zdrojová IP adresa, cílová IP adresa, protokol
  • žádný. Pět spřažení řazené kolekce členů: zdrojová IP adresa, zdrojový port, cílová IP adresa, cílový port, protokol

Výchozí hodnota není žádná.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LocalPort

Určuje místní privátní port, který tento koncový bod používá. Aplikace v rámci virtuálního počítače naslouchají na tomto portu pro požadavky na vstup služby pro tento koncový bod.

Typ:Int32
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název koncového bodu.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NoProbe

Označuje, že tato rutina nepoužívá žádné nastavení sondy.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProbeIntervalInSeconds

Určuje interval dotazování sondy v sekundách pro koncový bod.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProbePath

Určuje relativní cestu k sondě HTTP.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProbePort

Určuje port, který koncový bod používá.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProbeProtocol

Určuje protokol portu. Platné hodnoty jsou:

  • tcp
  • http
Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProbeTimeoutInSeconds

Určuje časový limit dotazování sondy v sekundách.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Protocol

Určuje protokol koncového bodu. Platné hodnoty jsou:

  • tcp
  • protokol udp
Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PublicPort

Určuje veřejný port, který koncový bod používá. Pokud nezadáte hodnotu, Azure přiřadí dostupný port.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VirtualIPName

Určuje název virtuální IP adresy, kterou Azure přidruží ke koncovému bodu. Vaše služba může mít několik virtuálních IP adres. K vytvoření virtuálních IP adres použijte rutinu Add-AzureVirtualIP .

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VM

Určuje virtuální počítač, do kterého koncový bod patří.

Typ:IPersistentVM
Aliasy:InputObject
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

Object