Udostępnij za pośrednictwem

Add-AzureEndpoint

  • Odwołanie
Moduł:
Azure

Dodaje punkt końcowy do maszyny wirtualnej.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Add-AzureEndpoint dodaje punkt końcowy do obiektu maszyny wirtualnej platformy Azure.

Przykłady

Przykład 1. Dodawanie punktu końcowego

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

To polecenie pobiera konfigurację maszyny wirtualnej o nazwie VirtualMachine01 przy użyciu polecenia cmdlet Get-AzureVM . Polecenie przekazuje je do bieżącego polecenia cmdlet przy użyciu operatora potoku. To polecenie cmdlet dodaje punkt końcowy o nazwie HttpIn. Punkt końcowy ma publiczny port 80 i port lokalny 8080. Polecenie przekazuje obiekt maszyny wirtualnej do polecenia cmdlet Update-AzureVM , które implementuje zmiany.

Przykład 2. Dodawanie punktu końcowego należącego do grupy o zrównoważonym obciążeniu

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

To polecenie pobiera konfigurację maszyny wirtualnej o nazwie VirtualMachine07. Bieżące polecenie cmdlet dodaje punkt końcowy o nazwie HttpIn. Punkt końcowy ma publiczny port 80 i port lokalny 8080. Punkt końcowy należy do udostępnionej grupy o zrównoważonym obciążeniu o nazwie WebFarm. Sonda HTTP na porcie 80 ze ścieżką "/" monitoruje dostępność punktu końcowego. Polecenie implementuje zmiany.

Przykład 3. Kojarzenie wirtualnego adresu IP z punktem końcowym

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

To polecenie pobiera konfigurację maszyny wirtualnej o nazwie VirtualMachine25. Bieżące polecenie cmdlet dodaje punkt końcowy o nazwie HttpIn. Punkt końcowy ma publiczny port 80 i port lokalny 8080. To polecenie kojarzy wirtualny adres IP z punktem końcowym. Polecenie implementuje zmiany.

Parametry

-ACL

Określa obiekt konfiguracji listy kontroli dostępu (ACL) dla punktu końcowego.

Typ:NetworkAclObject
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProbe

Wskazuje, że to polecenie cmdlet używa domyślnego ustawienia sondy.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DirectServerReturn

Określa, czy to polecenie cmdlet umożliwia bezpośredni zwrot serwera. Określ $True, aby włączyć lub $False wyłączyć.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IdleTimeoutInMinutes

Określa limit czasu bezczynności protokołu TCP w minutach dla punktu końcowego.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • SilentlyContinue
  • Zatrzymaj
  • Wstrzymanie
Typ:ActionPreference
Aliasy:infa
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliasy:iv
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InternalLoadBalancerName

Określa nazwę wewnętrznego modułu równoważenia obciążenia.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LBSetName

Określa nazwę zestawu modułu równoważenia obciążenia dla punktu końcowego.

Typ:String
Aliasy:LoadBalancedEndpointSetName
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LoadBalancerDistribution

Określa algorytm dystrybucji modułu równoważenia obciążenia. Prawidłowe wartości to:

  • sourceIP. Koligacja dwu krotki: źródłowy adres IP, docelowy adres IP
  • sourceIPProtocol. Koligacja krotki: źródłowy adres IP, docelowy adres IP, protokół
  • żaden. Koligacja krotki z pięcioma krotkami: źródłowy adres IP, port źródłowy, docelowy adres IP, port docelowy, protokół

Wartość domyślna to brak.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LocalPort

Określa lokalny, prywatny port używany przez ten punkt końcowy. Aplikacje na maszynie wirtualnej nasłuchują na tym porcie dla żądań wejściowych usługi dla tego punktu końcowego.

Typ:Int32
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę punktu końcowego.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NoProbe

Wskazuje, że to polecenie cmdlet nie używa ustawienia sondy.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProbeIntervalInSeconds

Określa interwał sondowania w sekundach dla punktu końcowego.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProbePath

Określa ścieżkę względną do sondy HTTP.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProbePort

Określa port używany przez punkt końcowy.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProbeProtocol

Określa protokół portu. Prawidłowe wartości to:

  • tcp
  • http
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProbeTimeoutInSeconds

Określa limit czasu sondowania sondy w sekundach.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Protocol

Określa protokół punktu końcowego. Prawidłowe wartości to:

  • tcp
  • Udp
Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicPort

Określa publiczny port używany przez punkt końcowy. Jeśli nie określisz wartości, platforma Azure przypisze dostępny port.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VirtualIPName

Określa nazwę wirtualnego adresu IP, który platforma Azure kojarzy z punktem końcowym. Twoja usługa może mieć wiele wirtualnych adresów IP. Aby utworzyć wirtualne adresy IP, użyj polecenia cmdlet Add-AzureVirtualIP .

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VM

Określa maszynę wirtualną, do której należy punkt końcowy.

Typ:IPersistentVM
Aliasy:InputObject
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Object