Set-UMIPGateway
이 cmdlet은 온-프레미스 Exchange에서만 제공됩니다.
Set-UMIPGateway cmdlet을 사용하면 단일 UM(통합 메시징) IP 게이트웨이의 구성 설정을 수정하거나 지정된 UM IP 게이트웨이에서 수정할 수 있는 구성 설정 목록을 반환할 수 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Set-UMIPGateway
[-Identity] <UMIPGatewayIdParameter>
[-Address <UMSmartHost>]
[-Confirm]
[-DelayedSourcePartyInfoEnabled <Boolean>]
[-DomainController <Fqdn>]
[-ForceUpgrade]
[-IPAddressFamily <IPAddressFamily>]
[-MessageWaitingIndicatorAllowed <Boolean>]
[-Name <String>]
[-OutcallsAllowed <Boolean>]
[-Port <Int32>]
[-Simulator <Boolean>]
[-Status <GatewayStatus>]
[-WhatIf]
[<CommonParameters>]Description
Set-UMIPGateway cmdlet은 특정 UM IP 게이트웨이의 구성 설정을 수정합니다(예: IP 게이트웨이의 IP 주소). 이러한 수정 내용에는 나가는 호출 허용과 SIP(Session Initiation Protocol) 사용이 가능한 IP PBX(Private Branch Exchange) 또는 IP 게이트웨이와의 통신 제어가 포함됩니다.
UM IP 게이트웨이 설정을 수정하면 사서함 서버와 SIP 사용 IP PBX 또는 IP 게이트웨이 간의 통신이 중단될 수 있습니다. UM IP 게이트웨이에 대한 수정 작업은 UM IP 게이트웨이에 대한 구성 변경의 의미를 완전히 이해하는 관리자만 수행해야 합니다.
이 작업을 완료하면 지정된 매개 변수와 값이 UM IP 게이트웨이에 구성됩니다.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1이 예에서는 MyUMIPGateway라는 UM IP 게이트웨이의 IP 주소를 수정합니다.
예 2
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status Disabled -OutcallsAllowed $false이 예에서는 UM IP 게이트웨이가 들어오는 호출을 수락하지 않도록 하고 나가는 호출을 차단합니다.
예 3
Set-UMIPGateway -Identity MyUMIPGateway -Address fe80::39bd:88f7:6969:d223%11 -IPAddressFamily Any -Status Disabled -OutcallsAllowed $false이 예에서는 UM IP 게이트웨이 MyUMIPGateway가 수신 전화를 받지 못하게 하고 발신 전화를 방지하며 IPv6 주소를 설정하고 UM IP 게이트웨이가 IPv4 및 IPV6 주소를 사용하도록 허용합니다.
예 4
Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true이 예에서는 UM IP 게이트웨이가 IP 게이트웨이 시뮬레이터로 작동할 수 있도록 하며, Test-UMConnectivity cmdlet과 함께 사용할 수 있습니다.
매개 변수
-Address
Address 매개 변수는 UM IP 게이트웨이 또는 SIP 사용 IP PBX에 구성된 FQDN(정규화된 도메인 이름) 또는 IP 주소를 지정합니다. FQDN은 UM IP 게이트웨이와 연결된 UM 다이얼 플랜이 SIP 보안 또는 보안 모드에서 작동하고 있는 경우에 필요합니다. FQDN을 사용하는 경우 DNS(Domain Name System)가 올바르게 구성되었는지 확인합니다.
| Type: | UMSmartHost |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Confirm
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DelayedSourcePartyInfoEnabled
DelayedSourcePartyInfoEnabled 매개 변수는 호출의 해당 SIP INVITE에 발신자 및 전환 정보가 포함되지 않은 경우 VoIP(Voice over IP) 게이트웨이에서 인바운드 호출을 수락하는 과정을 통합 메시징에서 지연해야 하는지 여부를 지정합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DomainController
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-ForceUpgrade
ForceUpgrade 스위치는 개체가 이전 버전의 Exchange에서 만들어진 경우 표시되는 확인 메시지를 표시하지 않습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Identity
Identity 매개 변수는 수정되는 UM IP 게이트웨이의 식별자를 지정합니다. 이 매개 변수는 UM IP 게이트웨이에 대한 디렉터리 개체 ID입니다.
| Type: | UMIPGatewayIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-IPAddressFamily
IPAddressFamily 매개 변수는 UM IP 게이트웨이가 통신에 IPv4(인터넷 프로토콜 버전 4)나 IPv6을 사용할지, 또는 둘 다를 사용할지를 지정합니다. 유효한 값은 다음과 같습니다.
- IPv4Only: UM IP 게이트웨이는 IPv4만 사용하여 통신합니다. 이 값은 기본값입니다.
- IPv6Only: UM IP 게이트웨이는 IPv6만 사용합니다.
- Any: IPv6이 먼저 사용되고 필요한 경우 IPv4로 대체됩니다.
| Type: | IPAddressFamily |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016 |
-MessageWaitingIndicatorAllowed
MessageWaitingIndicatorAllowed 매개 변수는 UM IP 게이트웨이가 UM 다이얼 플랜 및 UM IP 게이트웨이와 연결된 사용자에게 SIP NOTIFY 메시지를 보낼 수 있도록 할지 여부를 지정합니다. 기본값은 $true입니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Name
Name 매개 변수는 UM IP 게이트웨이의 표시 이름을 지정합니다. 이 표시 이름은 64자로 제한됩니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-OutcallsAllowed
OutcallsAllowed 매개 변수는 나가는 호출에 UM IP 게이트웨이를 사용할 수 있도록 할지 여부를 지정합니다. 이 매개 변수는 호출 전송에는 적용되지 않습니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Port
Port 매개 변수는 IP 게이트웨이 또는 IP PBX가 수신 대기하는 IP 포트를 지정합니다. 기본적으로 포트 5060입니다. 이 매개 변수의 범위는 0에서 65535까지입니다.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Simulator
Simulator 매개 변수는 표시되는 UM IP 게이트웨이에 사용할 시뮬레이터를 지정합니다. 시뮬레이터를 통해 클라이언트를 사서함 서버에 연결할 수 있습니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Status
Status 매개 변수는 UM IP 게이트웨이를 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- 사용
- 사용 안 함
- NoNewCalls
| Type: | GatewayStatus |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-WhatIf
Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.