Set-UMIPGateway(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2007-07-12
Set-UMIPGateway cmdlet는 단일 UM(통합 메시징) IP 게이트웨이의 구성 설정을 수정하거나 해당 UM IP 게이트웨이에서 수정할 수 있는 구성 설정 목록을 반환하는 데 사용합니다.
구문
Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
Set-UMIPGateway [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
자세한 정보
Set-UMIPGateway cmdlet는 해당 UM IP 게이트웨이의 구성 설정(예: IP 게이트웨이의 IP 주소)을 수정합니다. 이러한 수정 사항에는 나가는 호출 허용과 SIP 사용 가능 IP/PBX 또는 IP 게이트웨이와의 통신 제어가 포함됩니다.
중요
UM IP 게이트웨이 설정을 수정하면 통합 메시징 서버와 SIP 사용 가능 또는 IP PBX IP 게이트웨이 간의 통신이 중단될 수 있습니다. UM IP 게이트웨이 개체에 대한 수정 작업은 UM IP 게이트웨이에 대한 구성 변경의 의미를 완전히 이해하는 관리자만 수행해야 합니다.
Set-UMIPGateway cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
- Exchange 조직 관리자 역할
사용 권한, 역할 위임 및 Microsoft Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
Identity |
필수 |
Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter |
수정되는 UM IP 게이트웨이의 식별자를 지정하는 매개 변수입니다. 이 매개 변수는 UM IP 게이트웨이에 대한 디렉터리 개체 ID입니다. |
주소 |
선택 |
Microsoft.Exchange.Data.UMSmartHost |
이 매개 변수는 IP 게이트웨이 또는 SIP(Session Initiation Protocol) 사용 가능 IP/PBX(Private Branch eXchange)에 구성된 IP 주소를 지정합니다. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
이 구성 변경을 Active Directory 디렉터리 서비스에 기록하는 도메인 컨트롤러의 정규화된 도메인 이름을 지정하려면 cmdlet에 DomainController 매개 변수를 포함시킵니다. |
Instance |
선택 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway |
새 IP 게이트웨이를 나타내는 입력 매개 변수를 지정하는 매개 변수입니다. |
Name |
선택 |
System.String |
UM IP 게이트웨이에 사용되는 표시 이름을 지정하는 매개 변수입니다. 이 표시 이름은 64자로 제한됩니다. |
OutcallsAllowed |
선택 |
System.Boolean |
이 IP 게이트웨이 개체를 나가는 호출에 사용할 지 여부를 지정하는 매개 변수입니다. 이 매개 변수는 호출 전송에는 적용되지 않습니다. |
Port |
선택 |
System.Int32 |
이 매개 변수는 IP 게이트웨이 또는 IP PBX가 수신하는 IP 포트를 지정합니다. 이 매개 변수의 기본값은 포트 5060이고 범위는 0에서 65535까지입니다. |
Simulator |
선택 |
System.Boolean |
보고 있는 UM IP 게이트웨이에 사용할 시뮬레이터를 지정하는 매개 변수입니다. 시뮬레이터를 통해 클라이언트를 통합 메시징 서버에 연결할 수 있습니다. 일반적으로 이러한 연결은 Exchange 전화 테스트 응용 프로그램에서 사용됩니다. |
Status |
선택 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus |
이 매개 변수는 UM IP 게이트웨이를 사용하거나 사용하지 않을지 여부를 지정합니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
|
예외
| 예외 | 설명 |
|---|---|
|
|
예제
첫 번째 코드 예에서는 MyUMIPGateway라는 UM IP 게이트웨이의 IP 주소를 수정합니다.
두 번째 코드 예에서는 UM IP 게이트웨이가 들어오는 호출을 수락하지 않도록 하고 나가는 호출을 차단합니다.
세 번째 예에서는 UM IP 게이트웨이가 IP/VoIP 시뮬레이터로 작동하도록 설정합니다.
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status 2 -OutcallsAllowed $false
Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true