Udostępnij za pośrednictwem


Set-AzureEndpoint

Modyfikuje punkt końcowy przypisany 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

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

Opis

Polecenie cmdlet Set-AzureEndpoint modyfikuje punkt końcowy przypisany do maszyny wirtualnej platformy Azure. Możesz określić zmiany w punkcie końcowym, który nie jest zrównoważony.

Przykłady

Przykład 1. Modyfikowanie punktu końcowego w celu nasłuchiwania na porcie

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Set-AzureEndpoint -Name "Web" -PublicPort 443 -LocalPort 443 -Protocol tcp | 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 modyfikuje punkt końcowy o nazwie Web, aby nasłuchiwać na porcie 443. Polecenie przekazuje obiekt maszyny wirtualnej do polecenia cmdlet Update-AzureVM , które implementuje zmiany.

Parametry

-ACL

Określa obiekt konfiguracji listy kontroli dostępu (ACL), który ma zastosowanie do punktu końcowego.

Typ:NetworkAclObject
Position:Named
Domyślna wartość:None
Wymagane:False
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

-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:False
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

-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:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicPort

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

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