Set-UMIPGateway
적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
마지막으로 수정된 항목: 2007-07-17
Set-UMIPGateway cmdlet는 단일 UM(통합 메시징) IP 게이트웨이의 구성 설정을 수정하거나 해당 UM IP 게이트웨이에서 수정할 수 있는 구성 설정 목록을 반환하는 데 사용합니다.
구문
Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]
Set-UMIPGateway [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]
자세한 설명
Set-UMIPGateway cmdlet는 해당 UM IP 게이트웨이의 구성 설정(예: IP 게이트웨이의 IP 주소)을 수정합니다. 이러한 수정 사항에는 나가는 호출 허용과 SIP(Session Initiation Protocol) 사용 가능 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입니다. |
Address |
선택 |
Microsoft.Exchange.Data.UMSmartHost |
IP 게이트웨이 또는 SIP 사용 가능 IP/PBX(Private Branch eXchange)에서 구성되는 IP 주소를 지정하는 매개 변수입니다. |
Confirm |
선택 |
System.Management.Automation.SwitchParameter |
이 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. 기본값은 $true입니다. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
이 매개 변수는 이 구성 변경을 Active Directory 디렉터리 서비스에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정합니다. |
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 게이트웨이를 사용하거나 사용하지 않을지 여부를 지정합니다. |
WhatIf |
선택 |
System.Management.Automation.SwitchParameter |
이 매개 변수는 명령 실행 시에 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 관리자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. 기본값은 $true입니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
|
예외
| 예외 | 설명 |
|---|---|
|
|
예제
첫 번째 코드 예에서는 MyUMIPGateway라는 UM IP 게이트웨이의 IP 주소를 수정합니다.
두 번째 코드 예에서는 UM IP 게이트웨이가 들어오는 호출을 수락하지 않도록 하고 나가는 호출을 차단합니다.
세 번째 예에서는 UM IP 게이트웨이가 IP 시뮬레이터로 작동하도록 설정하며 이것은 Test-UMConnectivity cmdlet 또는 Exchange UM 테스트용 전화 응용 프로그램과 함께 사용됩니다.
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