Set-UMIPGateway

 

적용 대상:Exchange Online, Exchange Server 2016

마지막으로 수정된 항목:2016-03-31

이 cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

Set-UMIPGateway cmdlet을 사용하면 단일 UM(통합 메시징) IP 게이트웨이의 구성 설정을 수정하거나 지정된 UM IP 게이트웨이에서 수정할 수 있는 구성 설정 목록을 반환할 수 있습니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하세요.

Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DelayedSourcePartyInfoEnabled <$true | $false>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IPAddressFamily <IPv4Only | IPv6Only | Any>] [-MessageWaitingIndicatorAllowed <$true | $false>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

이 예에서는 MyUMIPGateway라는 UM IP 게이트웨이의 IP 주소를 수정합니다.

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1

이 예에서는 UM IP 게이트웨이가 들어오는 호출을 수락하지 않도록 하고 나가는 호출을 차단합니다.

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status Disabled -OutcallsAllowed $false

이 예에서는 UM IP 게이트웨이 MyUMIPGateway가 수신 전화를 받지 못하게 하고 발신 전화를 방지하며 IPv6 주소를 설정하고 UM IP 게이트웨이가 IPv4 및 IPV6 주소를 사용하도록 허용합니다.

Set-UMIPGateway -Identity MyUMIPGateway -Address fe80::39bd:88f7:6969:d223%11 -IPAddressFamily Any -Status Disabled -OutcallsAllowed $false

이 예에서는 UM IP 게이트웨이가 IP 게이트웨이 시뮬레이터로 작동할 수 있도록 하며, Test-UMConnectivity cmdlet과 함께 사용할 수 있습니다.

Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true

Set-UMIPGateway cmdlet은 특정 UM IP 게이트웨이의 구성 설정을 수정합니다(예: IP 게이트웨이의 IP 주소). 이러한 수정 내용에는 나가는 호출 허용과 SIP(Session Initiation Protocol) 사용이 가능한 IP PBX(Private Branch Exchange) 또는 IP 게이트웨이와의 통신 제어가 포함됩니다.

important중요:
UM IP 게이트웨이 설정을 수정하면 사서함 서버와 SIP 사용 IP PBX 또는 IP 게이트웨이 간의 통신이 중단될 수 있습니다. UM IP 게이트웨이에 대한 수정 작업은 UM IP 게이트웨이에 대한 구성 변경의 의미를 완전히 이해하는 관리자만 수행해야 합니다.

이 작업을 완료하면 지정된 매개 변수와 값이 UM IP 게이트웨이에 구성됩니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 cmdlet의 모든 매개 변수가 이 항목에 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 필요한 사용 권한을 확인하려면 다음을 참조하세요.통합된 메시징 사용 권한의 "UM IP 게이트웨이" 항목

 

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

Identity 매개 변수는 수정되는 UM IP 게이트웨이의 식별자를 지정합니다. 이 매개 변수는 UM IP 게이트웨이에 대한 디렉터리 개체 ID입니다.

Address

선택

Microsoft.Exchange.Data.UMSmartHost

Address 매개 변수는 UM IP 게이트웨이 또는 SIP 사용 IP PBX에 구성된 FQDN(정규화된 도메인 이름) 또는 IP 주소를 지정합니다. FQDN은 UM IP 게이트웨이와 연결된 UM 다이얼 플랜이 SIP 보안 또는 보안 모드에서 작동하고 있는 경우에 필요합니다. FQDN을 사용하는 경우 DNS(Domain Name System)가 올바르게 구성되었는지 확인합니다.

Confirm

선택

System.Management.Automation.SwitchParameter

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 이 스위치가 cmdlet에 영향을 미치는 방식은 계속하기 전에 cmdlet이 확인을 요구하는지에 따라 달라집니다.

  • 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.

  • 대부분의 다른 cmdlet(예: New-*Set-* cmdlet)에는 일시 중지 기능이 기본 제공되어 있지 않습니다. 이러한 cmdlet의 경우 값 없이 Confirm 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

DelayedSourcePartyInfoEnabled

선택

System.Boolean

DelayedSourcePartyInfoEnabled 매개 변수는 호출의 해당 SIP INVITE에 발신자 및 전환 정보가 포함되지 않은 경우 VoIP(Voice over IP) 게이트웨이에서 인바운드 호출을 수락하는 과정을 통합 메시징에서 지연해야 하는지 여부를 지정합니다.

DomainController

옵션

Microsoft.Exchange.Data.Fqdn

이 매개 변수는 온-프레미스 Exchange에서만 제공됩니다.

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 데이터를 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화 된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

ForceUpgrade

선택

System.Management.Automation.SwitchParameter

이 매개 변수는 온-프레미스 Exchange에서만 제공됩니다.

ForceUpgrade 스위치는 UM IP 게이트웨이 개체가 업그레이드되기 전에 확인 메시지를 표시할지 여부를 지정합니다.

IPAddressFamily

선택

Microsoft.Exchange.Data.Directory.IPAddressFamily

IPAddressFamily 매개 변수는 UM IP 게이트웨이가 통신에 IPv4(인터넷 프로토콜 버전 4)나 IPv6을 사용할지, 또는 둘 다를 사용할지를 지정합니다. 이 매개 변수를 IPv4Only로 설정하면 UM IP 게이트웨이가 통신에 IPv4만 사용합니다. 이 매개 변수를 IPv6Only로 설정하면 UM IP 게이트웨이가 IPv6만 사용합니다. 이 매개 변수를 Any로 설정하면 IPv6을 먼저 사용하고 필요에 따라 IPv4로 변경합니다. 기본값은 IPv4Only입니다.

MessageWaitingIndicatorAllowed

선택

System.Boolean

MessageWaitingIndicatorAllowed 매개 변수는 UM IP 게이트웨이가 UM 다이얼 플랜 및 UM IP 게이트웨이와 연결된 사용자에게 SIP NOTIFY 메시지를 보낼 수 있도록 할지 여부를 지정합니다. 기본값은 $true입니다.

Name

선택

System.String

Name 매개 변수는 UM IP 게이트웨이의 표시 이름을 지정합니다. 이 표시 이름은 64자로 제한됩니다.

OutcallsAllowed

선택

System.Boolean

OutcallsAllowed 매개 변수는 나가는 호출에 UM IP 게이트웨이를 사용할 수 있도록 할지 여부를 지정합니다. 이 매개 변수는 호출 전송에는 적용되지 않습니다.

Port

옵션

System.Int32

Port 매개 변수는 IP 게이트웨이 또는 IP PBX가 수신하는 IP 포트를 지정합니다. 이 매개 변수의 기본값은 포트 5060이고 범위는 0에서 65535 사이입니다.

Simulator

선택

System.Boolean

Simulator 매개 변수는 표시되는 UM IP 게이트웨이에 사용할 시뮬레이터를 지정합니다. 시뮬레이터를 통해 클라이언트를 사서함 서버에 연결할 수 있습니다.

Status

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus

Status 매개 변수는 UM IP 게이트웨이를 사용할지 여부를 지정합니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

WhatIf 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하여 값을 지정할 필요가 없습니다.

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

 
표시: