다음을 통해 공유


Add-AzureEndpoint

가상 머신에 엔드포인트를 추가합니다.

참고

이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.

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

Add-AzureEndpoint cmdlet은 Azure 가상 머신 개체에 엔드포인트를 추가합니다.

예제

예제 1: 엔드포인트 추가

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

이 명령은 Get-AzureVM cmdlet을 사용하여 VirtualMachine01이라는 가상 머신의 구성을 검색합니다. 이 명령은 파이프라인 연산자를 사용하여 현재 cmdlet에 전달합니다. 이 cmdlet은 HttpIn이라는 엔드포인트를 추가합니다. 엔드포인트에는 공용 포트 80 및 로컬 포트 8080이 있습니다. 이 명령은 변경 내용을 구현하는 Update-AzureVM cmdlet에 가상 머신 개체를 전달합니다.

예제 2: 부하 분산된 그룹에 속하는 엔드포인트 추가

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

이 명령은 VirtualMachine07이라는 가상 머신의 구성을 검색합니다. 현재 cmdlet은 HttpIn이라는 엔드포인트를 추가합니다. 엔드포인트에는 공용 포트 80 및 로컬 포트 8080이 있습니다. 엔드포인트는 WebFarm이라는 공유 부하 분산 그룹에 속합니다. 경로가 '/'인 포트 80의 HTTP 프로브는 엔드포인트의 가용성을 모니터링합니다. 이 명령은 변경 내용을 구현합니다.

예제 3: 가상 IP를 엔드포인트에 연결

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

이 명령은 VirtualMachine25라는 가상 머신의 구성을 검색합니다. 현재 cmdlet은 HttpIn이라는 엔드포인트를 추가합니다. 엔드포인트에는 공용 포트 80 및 로컬 포트 8080이 있습니다. 이 명령은 가상 IP를 엔드포인트에 연결합니다. 이 명령은 변경 내용을 구현합니다.

매개 변수

-ACL

엔드포인트에 대한 ACL(액세스 제어 목록) 구성 개체를 지정합니다.

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

-DefaultProbe

이 cmdlet이 기본 프로브 설정을 사용한다는 것을 나타냅니다.

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

-DirectServerReturn

이 cmdlet에서 직접 서버 반환을 사용할 수 있는지 여부를 지정합니다. 사용하도록 설정할 $True 지정하거나 사용하지 않도록 설정할 $False 지정합니다.

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

-IdleTimeoutInMinutes

엔드포인트에 대한 TCP 유휴 제한 시간(분)을 지정합니다.

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

-InformationAction

이 cmdlet이 정보 이벤트에 응답하는 방법을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 계속
  • 무시
  • 문의
  • SilentlyContinue
  • Stop
  • 일시 중단
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

정보 변수를 지정합니다.

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

-InternalLoadBalancerName

내부 부하 분산 장치의 이름을 지정합니다.

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

-LBSetName

엔드포인트에 대해 설정된 부하 분산 장치의 이름을 지정합니다.

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

-LoadBalancerDistribution

부하 분산 장치 배포 알고리즘을 지정합니다. 유효한 값은 다음과 같습니다.

  • sourceIP. 두 튜플 선호도: 원본 IP, 대상 IP
  • sourceIPProtocol. 세 가지 튜플 선호도: 원본 IP, 대상 IP, 프로토콜
  • 없음. 5개의 튜플 선호도: 원본 IP, 원본 포트, 대상 IP, 대상 포트, 프로토콜

기본값은 none입니다.

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

-LocalPort

이 엔드포인트에서 사용하는 로컬, 프라이빗 포트를 지정합니다. 가상 머신 내의 애플리케이션은 이 엔드포인트에 대한 서비스 입력 요청에 대해 이 포트에서 수신 대기합니다.

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

-Name

엔드포인트의 이름을 지정합니다.

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

-NoProbe

이 cmdlet이 프로브 없음 설정을 사용한다는 것을 나타냅니다.

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

-ProbeIntervalInSeconds

엔드포인트에 대한 프로브 폴링 간격(초)을 지정합니다.

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

-ProbePath

HTTP 프로브의 상대 경로를 지정합니다.

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

-ProbePort

엔드포인트에서 사용하는 포트를 지정합니다.

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

-ProbeProtocol

포트 프로토콜을 지정합니다. 유효한 값은 다음과 같습니다.

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

-ProbeTimeoutInSeconds

프로브 폴링 제한 시간(초)을 지정합니다.

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

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

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

-Protocol

엔드포인트의 프로토콜을 지정합니다. 유효한 값은 다음과 같습니다.

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

-PublicPort

엔드포인트에서 사용하는 공용 포트를 지정합니다. 값을 지정하지 않으면 Azure에서 사용 가능한 포트를 할당합니다.

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

-VirtualIPName

Azure가 엔드포인트에 연결하는 가상 IP 주소의 이름을 지정합니다. 서비스에는 여러 가상 IP가 있을 수 있습니다. 가상 IP를 만들려면 Add-AzureVirtualIP cmdlet을 사용합니다.

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

-VM

엔드포인트가 속한 가상 머신을 지정합니다.

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

출력

Object