Set-UmServer

모듈:

ExchangePowerShell

적용 대상:

Exchange Server 2010

이 cmdlet은 Exchange Server 2010년에만 사용할 수 있습니다.

Set-UMServer cmdlet을 사용하여 UM(통합 메시징) 서버 역할과 연결된 설정을 수정합니다.

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

Syntax

Set-UmServer
   [-Identity] <UMServerIdParameter>
   [-Confirm]
   [-DialPlans <MultiValuedProperty>]
   [-DomainController <Fqdn>]
   [-ExternalServiceFqdn <UMSmartHost>]
   [-GrammarGenerationSchedule <ScheduleInterval[]>]
   [-IrmLogEnabled <Boolean>]
   [-IrmLogMaxAge <EnhancedTimeSpan>]
   [-IrmLogMaxDirectorySize <Unlimited>]
   [-IrmLogMaxFileSize <ByteQuantifiedSize>]
   [-IrmLogPath <LocalLongFullPath>]
   [-MaxCallsAllowed <Int32>]
   [-SIPAccessService <ProtocolConnectionSettings>]
   [-SipTcpListeningPort <Int32>]
   [-SipTlsListeningPort <Int32>]
   [-Status <ServerStatus>]
   [-UMStartupMode <UMStartupMode>]
   [-WhatIf]
   [<CommonParameters>]

Description

Set-UMServer cmdlet은 통합 메시징 서버에서 특정 속성을 설정합니다. 이 cmdlet을 사용하여 지정된 통합 메시징 서버에 대한 개별 통합 메시징 매개 변수를 설정할 수 있습니다.

이 작업을 완료하면 cmdlet은 매개 변수와 지정된 값을 설정합니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Set-UMServer -Identity MyUMServer -Status NoNewCalls

이 예제에서는 통합 메시징 서버 MyUMServer가 새 호출을 수락하지 못하도록 방지합니다.

예 2

Set-UMServer -Identity MyUMServer -DialPlans $null

이 예제에서는 모든 UM 다이얼 플랜에서 통합 메시징 서버 MyUMServer를 제거합니다.

예 3

Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCallsAllowed 50

다음은 통합 메시징 서버 MyUMServer를 UM 다이얼 플랜 MyUMDialPlanName에 추가하고 수신 음성 통화의 최대 수를 50으로 설정하는 예제입니다.

예 4

Set-UMServer -Identity MyUMServer -GrammarGenerationSchedule 0.02:30-1.03:00,1.02:30-1.03:00,2.02:30-2.03:00,3.02:30-3.03:00,4.02:30-4.03:00,5.02:30-5.03:00,6.02:30-6.03:00

다음은 통합 메시징 서버 MyUMServer에서 문법 생성 일정을 매일 02:30-03:00으로 변경하는 예제입니다.

매개 변수

-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

-DialPlans

DialPlans 매개 변수는 이 서버가 UM 호출을 처리할 모든 다이얼 플랜을 지정합니다. 다이얼 플랜이 정의되지 않은 경우 통합 메시징 서버는 UM 호출을 처리하지 않습니다.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-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

-ExternalServiceFqdn

ExternalServiceFqdn 매개 변수는 통합 메시징 서버를 서비스하는 부하 분산 장치의 FQDN 또는 호스트 이름입니다. 이 매개 변수는 조직 내에서 Microsoft Exchange Server 2010 호스팅 환경으로 통합 메시징 서버를 마이그레이션할 때 유용합니다. 외부 서비스 호스트 FQDN은 최대 2,048자를 포함할 수 있습니다.

Type:	UMSmartHost
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-GrammarGenerationSchedule

GrammarGenerationSchedule 매개 변수는 음성 문법 생성을 시작할 예약 시간을 지정합니다. 시작 시간은 하루에 하나씩만 허용됩니다. 문법 생성의 기본 예약 시간은 매일 현지 시간으로 02:00 – 02:30입니다.

이 매개 변수의 구문은 입니다 StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]. 여러 일정을 쉼표로 구분하여 지정할 수 있습니다. "Schedule1","Schedule2",..."ScheduleN"

며칠 동안 다음 값을 사용할 수 있습니다.

• 오늘의 전체 이름입니다.
• 날짜의 약어 이름입니다.
• 0에서 6까지의 정수이며, 여기서 0 = 일요일입니다.

시간을 24시간 형식으로 입력하고 AM/PM 값을 생략할 수 있습니다. 시간을 12시간 형식으로 입력하는 경우 시간과 AM/PM 값 사이의 공백을 포함합니다.

날짜/시간 형식을 혼합하고 일치시킬 수 있습니다.

시작 시간과 종료 시간은 최소한 15분 이상 차이가 나야 합니다. 분은 0, 15, 30 또는 45로 반올림됩니다. 간격을 둘 이상 지정하는 경우 각 간격 사이에는 시간 차를 15분 이상 두어야 합니다.

다음은 몇 가지 예입니다.

• "Sun.11:30 PM-Mon.1:30 AM"
• "6.22:00-6.22:15"(토요일 오후 10:00부터 토요일 오후 10:15까지 실행)
• "일요일 오전 1:15~월요일.23:00"
• "월요일.4:30 AM-월요일.5:30 AM","수요일.4:30 AM-수요일.5:30 AM" (월요일 및 수요일 아침 4:30부터 5:30까지 실행).

Type:	ScheduleInterval[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Identity

Identity 매개 변수는 수정하려는 통합 메시징 서버를 지정합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:

• 이름
• GUID
• DN(고유 이름)
• ExchangeLegacyDN

Type:	UMServerIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogEnabled

IrmLogEnabled 매개 변수는 IRM(정보 권한 관리) 트랜잭션의 로깅을 사용할지 여부를 지정합니다. IRM 로깅은 기본적으로 사용하도록 설정되어 있습니다. 값은 다음과 같습니다.

• IRM 로깅 사용 $true
• IRM 로깅 사용 안 함 $false

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogMaxAge

IrmLogMaxAge 매개 변수는 IRM 로그 파일의 최대 보존 기간을 지정합니다. 지정된 값보다 오래된 로그 파일은 삭제됩니다. 기본값은 30일입니다. 값을 지정하려면 시간 범위로 값을 입력합니다. dd.hh:mm:ss, 여기서 d = days, h = hours, m = minutes 및 s = seconds. 이 매개 변수에는 00:00:00에서 24855.03:14:07까지의 값을 입력할 수 있습니다. IrmLogMaxAge 매개 변수의 값을 00:00:00으로 설정하면 자체 보존 기간으로 인해 IRM 로그 파일이 자동으로 제거되는 것을 방지할 수 있습니다.

Type:	EnhancedTimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogMaxDirectorySize

IrmLogMaxDirectorySize 매개 변수는 연결 로그 디렉터리에 있는 모든 IRM 로그의 최대 크기를 지정합니다. 디렉터리가 최대 파일 크기에 도달하면 서버에서 가장 오래된 파일을 먼저 삭제합니다. 기본값은 250MB(메가바이트)입니다. 사용할 수 있는 값은 최대 1.999999999테라바이트(2199023254528바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 6기가바이트(6442450944바이트)입니다.

• B(바이트)
• KB(킬로바이트)
• MB(메가바이트)
• GB(기가바이트)
• TB(테라바이트)

정규화되지 않은 값은 바이트로 처리됩니다. IrmLogMaxFileSize 매개 변수의 값은 IrmLogMaxDirectorySize 매개 변수의 값보다 작거나 같아야 합니다. 각 매개 변수에는 1바이트에서 9223372036854775807바이트까지의 값을 입력할 수 있습니다. unlimited 값을 입력하면 연결 로그 디렉터리의 크기 제한이 없어집니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogMaxFileSize

IrmLogMaxFileSize 매개 변수는 각 IRM 로그 파일의 최대 크기를 지정합니다. 로그 파일이 최대 파일 크기에 도달하면 새 로그 파일이 만들어집니다. 기본값은 10MB입니다. 사용할 수 있는 값은 최대 1.999999999테라바이트(2199023254528바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 6기가바이트(6442450944바이트)입니다.

• B(바이트)
• KB(킬로바이트)
• MB(메가바이트)
• GB(기가바이트)
• TB(테라바이트)

정규화되지 않은 값은 바이트로 처리됩니다. IrmLogMaxFileSize 매개 변수의 값은 IrmLogMaxDirectorySize 매개 변수의 값보다 작거나 같아야 합니다. 각 매개 변수에는 1바이트에서 9223372036854775807바이트까지의 값을 입력할 수 있습니다. unlimited 값을 입력하면 IRM 로그 파일의 크기 제한이 없어집니다.

Type:	ByteQuantifiedSize
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogPath

IrmLogPath 매개 변수는 기본 IRM 로그 디렉터리 위치를 지정합니다. 기본값은 C:\Program Files\Microsoft\Exchange Server\V14입니다. IrmLogPath 매개 변수의 값을 $null로 설정하면 IRM 로깅을 사용할 수 없게 됩니다. 그러나 IrmLogEnabled 특성의 값이 $true 때 IrmLogPath 매개 변수의 값을 $null 설정하면 Exchange는 애플리케이션 이벤트 로그에 오류를 기록합니다. IRM 로깅을 사용하지 않도록 설정하는 기본 방법은 IrmLogEnabled 매개 변수를 $false 설정하는 것입니다.

Type:	LocalLongFullPath
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MaxCallsAllowed

MaxCallsAllowed 매개 변수는 통합 메시징 서버에서 허용하는 최대 동시 음성 호출 수를 지정합니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SIPAccessService

SIPAccessService 매개 변수는 원격 Lync 또는 네트워크 외부에 있는 비즈니스용 Skype 사용자의 인바운드 및 아웃바운드 호출에 대해 가장 가까운 Lync Server Edge 풀 또는 비즈니스용 Skype 서버 Edge 풀 위치의 FQDN 및 TCP 포트를 지정합니다.

Lync Server 또는 여러 지리적 지역에 걸쳐 있는 비즈니스용 Skype 서버 배포에서 항상 이 매개 변수를 사용하는 것이 좋습니다. 그렇지 않으면 통합 메시징 서버에서 원격 사용자와 지리적으로 가장 가깝지 않은 RTP(Real-Time 전송 프로토콜) 미디어 트래픽에 대한 풀을 선택할 수 있습니다.

값이 Exchange 서버에 가장 가까운 Lync Server Edge 풀 또는 비즈니스용 Skype 서버 Edge 풀을 식별하도록 각 통합 메시징 서버에 대해 이 매개 변수를 구성합니다.

Type:	ProtocolConnectionSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SipTcpListeningPort

SipTcpListeningPort 매개 변수는 들어오는 호출을 수신하기 위해 통합 메시징 서버에서 사용하는 TCP 포트를 지정합니다. 이 TCP 포트는 SIP 보안 또는 보안 모드를 사용하도록 구성되지 않은 UM 다이얼 플랜에 추가된 통합 메시징 서버에서 사용됩니다. 기본값은 포트 5060입니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SipTlsListeningPort

SipTlsListeningPort 매개 변수는 들어오는 호출을 수신하기 위해 통합 메시징 서버에서 사용하는 TLS(전송 계층 보안) 포트를 지정합니다. 이 TLS 포트는 SIP 보안 또는 보안 모드를 사용하도록 구성된 UM 다이얼 플랜에 추가되는 통합 메시징 서버에서 사용됩니다. 기본값은 포트 5061입니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Status

Status 매개 변수는 통합 메시징 서버 상태를 지정합니다. 사용 가능한 옵션은 사용, 사용 안 함 및 NoNewCalls입니다.

Type:	ServerStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-UMStartupMode

UMStartupMode 매개 변수는 통합 메시징 서버의 Microsoft Exchange 통합 메시징 서비스가 TCP, TLS 또는 이중 모드에서 시작될지 여부를 지정합니다. 통합 메시징 서버가 보안 설정이 다른 UM 다이얼 플랜에 추가되는 경우 이중 모드를 선택해야 합니다. 이중 모드에서 통합 메시징 서버는 포트 5060 및 5061에서 동시에 수신 대기할 수 있습니다. 시작 모드가 변경되면 Microsoft Exchange 통합 메시징 서비스를 다시 시작해야 합니다.

Type:	UMStartupMode
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-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

입력

Input types

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

출력

Output types

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