Set-UMDialplan(RTM)

 

적용 대상: Exchange Server 2007

마지막으로 수정된 항목: 2012-03-26

Set-UMDialplan cmdlet는 UM(통합 메시징) 다이얼 플랜에서 다양한 속성을 설정하는 데 사용할 수 있습니다.

구문

Set-UMDialPlan -Identity <UMDialPlanIdParameter> [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]

Set-UMDialPlan [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-Instance <UMDialPlan>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]

자세한 정보

Set-UMDialplan cmdlet를 사용하면 기존 UM 다이얼 플랜의 속성을 변경하거나 수정할 수 있습니다. 일부 UM 다이얼 플랜 속성은 기본적으로 필요하여 만들어집니다. 그러나 어떤 경우 UM 다이얼 플랜이 만들어진 후 일부 UM 다이얼 플랜 속성은 쓰기가 가능하지 않습니다. 따라서 기존 UM 다이얼 플랜이 삭제되고 새로운 다이얼 플랜이 만들어져야 이러한 일부 속성을 변경할 수 있습니다.

중요

UM 다이얼 플랜은 통합 메시징 작업에 중요합니다. UM 다이얼 플랜 변경을 이해하고 있는 관리자가 기존 UM 다이얼 플랜의 수정 작업을 수행해야 합니다.

Set-UMDialplan cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • Exchange 조직 관리자 역할

사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

매개 변수

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

이 매개 변수는 UM 다이얼 플랜 ID를 지정합니다. 이 매개 변수는 UM 다이얼 플랜에 대한 디렉터리 개체 식별자입니다. 이 매개 변수는 사서함을 다이얼 플랜으로 연결하고 통합 메시징 서버를 다이얼 플랜으로 연결하는 데 사용됩니다.

AccessTelephoneNumbers

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 유효한 단일 음성 메시지 파일럿 번호나 유효한 음성 메시지 파일럿 번호의 목록을 지정합니다. 이 목록은 사용자가 통합 메시징에 대해 활성화되어 있을 때 관리자에게 나타납니다.

AllowDialPlanSubscribers

선택

System.Boolean

이 매개 변수는 동일한 다이얼 플랜 내에서 구독자로 확인되는 전화 번호로 구독자가 전화를 걸 수 있는지 여부를 지정합니다. 기본값은 $true입니다.

AllowedInCountryOrRegionGroups

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 전화를 걸 수 있는 동일한 다이얼 그룹에서 국내/지역 이름 목록을 지정합니다. 허용된 국내/지역 그룹 이름은 UM 다이얼 플랜에 지정된 그룹 이름과 일치해야 합니다.

AllowedInternationalGroups

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 허용되는 국제 다이얼 그룹 이름의 목록을 지정합니다. 국제 다이얼 그룹 이름은 다이얼 플랜에 지정된 그룹 이름과 일치해야 합니다.

AllowExtensions

선택

System.Boolean

이 매개 변수는 다이얼 플랜 내선 통화의 허용 여부를 지정합니다. 기본값은 $false입니다.

AudioCodec

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum

이 매개 변수는 녹음에 사용되는 오디오 코덱을 지정합니다. 기본 설정은 WMA입니다.

AutomaticSpeechRecognitionEnabled

선택

System.Boolean

이 매개 변수는 다이얼 플랜의 구성원인 사용자에 대해 음성 인식의 사용 가능 여부를 지정합니다.

CallSomeoneEnabled

선택

System.Boolean

이 매개 변수는 음성 전화 걸기 기능의 사용 가능 여부를 지정합니다.

ConfiguredInCountryOrRegionGroups

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 사용할 수 있는 국내 그룹을 지정합니다. 각 문자열은 다음과 같이 네 부분으로 구성됩니다.

  • 그룹 이름(32자까지 가능)

  • AllowedNumberString

  • DialNumberString

  • TextComment

ConfiguredInternationalGroups

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 사용할 수 있는 국제 그룹을 지정합니다. 각 문자열은 다음과 같이 네 부분으로 구성됩니다.

  • 그룹 이름(32자까지 가능)

  • AllowedNumberString

  • DialNumberString

  • TextComment

ContactAddressList

선택

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

이 매개 변수는 주소 목록의 ID를 지정합니다. ContactScope 매개 변수가 AddressList로 설정되면 디렉터리 검색에 대한 범위를 정의합니다.

ContactRecipientContainer

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

디렉터리 검색에 사용되는 컨테이너의 이름이나 ID입니다.

ContactScope

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.CallSomeoneScopeEnum

이 매개 변수는 전화를 건 사람이 UM 다이얼 플랜에 액세스하고 사용자 이름을 지정할 때 전화를 건 사람에게 부여되는 디렉터리 검색의 범위를 지정합니다.

CountryOrRegionCode

선택

System.String

이 매개 변수는 해당 국가나 지역에 대한 국가 또는 지역 코드를 지정합니다. 이는 특정 국가나 지역에 전화를 걸 때 사용하는 번호입니다. 예를 들어, 미국일 경우 1을 사용합니다.

DefaultLanguage

선택

Microsoft.Exchange.Data.UMLanguage

이 매개 변수는 시스템의 기본 언어를 지정합니다. 기본 언어는 사용 가능한 언어 목록에서 선택됩니다. 기본값은 영어(미국)입니다.

DialByNamePrimary

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNamePrimaryEnum

이 매개 변수는 지정된 원본에서 만들어지는 이름으로 전화 걸기 조회 키를 지정합니다. 기본값은 성, 이름입니다.

DialByNameSecondary

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNameSecondaryEnum

이 매개 변수는 지정된 원본에서 만들어지는 이름으로 전화 걸기 보조 조회 키를 지정합니다. 기본값은 SMTP입니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

이 구성 변경을 Active Directory 디렉터리 서비스에 기록하는 도메인 컨트롤러의 정규화된 도메인 이름을 지정하려면 해당 cmdlet에 DomainController 매개 변수를 포함시킵니다.

EquivalenceDialPlan

선택

System.Guid

이 매개 변수는 다른 포리스트에서 등가의 다이얼 플랜 이름을 지정합니다. 전화 통신 다이얼 플랜이 두 개의 포리스트에 걸쳐 있고 두 번째 다이얼 플랜 개체가 만들어질 때 원본 다이얼 플랜의 GUID는 다른 포리스트에 있는 사용자의 프록시 주소에 복사됩니다.

Extension

선택

System.String

이 매개 변수는 통화를 전송할 때 음성 전화 걸기 기능에서 사용하는 내선 번호를 지정합니다.

FaxEnabled

선택

System.Boolean

이 매개 변수는 시스템에서 팩스 기능을 지원할지 여부를 지정합니다. 다이얼 플랜이 팩스 기능을 지원하지 않으면 통합 메시징 서버는 팩스 구성 요소를 로드하지 않습니다. 기본값은 $true입니다.

FDSPollingInterval

선택

System.Int32

게시 지점에서 파일 배포 서비스에서 만든 새 콘텐츠에 대한 확인 간격(분)입니다. 범위는 1분에서 1440분까지이며, 기본값은 5분입니다.

InCountryOrRegionNumberFormat

선택

Microsoft.Exchange.Data.NumberFormat

이 매개 변수는 디렉터리에서 사용할 접두 문자열과 자릿수를 지정합니다. 이 숫자는 같은 국가나 지역 코드 내에서 이 다이얼 플랜으로 전화를 걸 때 사용됩니다.

InfoAnnouncementEnabled

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum

이 매개 변수는 정보 알림 사용 가능 여부를 지정합니다. 이 매개 변수는 Enabled, Disabled 또는 Uninterruptible로 설정할 수 있습니다. 기본값은 $true입니다.

InfoAnnouncementFilename

선택

System.String

이 매개 변수는 정보 알림에 사용할 오디오 파일 이름을 지정합니다.

InputFailuresBeforeDisconnect

선택

System.Int32

이 매개 변수는 통화 연결이 해제되기 전에 허용되는 연속적으로 발생한 사용자 입력 오류 횟수를 지정합니다. 기본값은 3입니다.

InputRetries

선택

System.Int32

이 매개 변수는 시스템 시간이 초과될 때까지 전화를 건 사람이 재입력을 시도할 수 있는 횟수를 지정합니다. 이는 인증된 사용자와 전화 응답 또는 자동 전화 교환 사용자에게도 적용됩니다. 기본값은 3입니다.

InputTimeout

선택

System.Int32

이 매개 변수는 사용자 입력을 위해 시스템이 기다리는 시간을 지정합니다. 이 시간 제한은 인증된 사용자, 전화 응답 또는 자동 전화 교환 사용자에게도 적용됩니다. 기본값은 5초입니다.

Instance

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMDialPlan

이 매개 변수는 새 다이얼 플랜 개체를 나타내는 입력 매개 변수를 지정합니다.

InternationalAccessCode

선택

System.String

이 매개 변수는 국제 통화에 사용되는 전화 번호에 미리 추가되는 코드를 지정합니다. 예를 들어, 미국에 전화를 걸 때는 011이 미리 추가됩니다.

InternationalNumberFormat

선택

Microsoft.Exchange.Data.NumberFormat

이 매개 변수는 다른 국가 코드에서 이 다이얼 플랜으로 전화를 걸 때 디렉터리에서 사용할 접두 문자열과 자릿수를 지정합니다.

LogonFailuresBeforeDisconnect

선택

System.Int32

이 매개 변수는 통화 연결이 해제되기 전에 허용되는 연속적으로 발생한 실패한 로그온 시도 횟수를 지정합니다. 기본값은 3입니다.

MatchedNameSelectionMethod

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.DisambiguationFieldEnum

이 매개 변수는 누름 단추식 입력이나 음성 입력과 일치하는 이름을 가진 사용자를 구별하는 데 사용할 선택을 지정합니다. 다음과 같이 설정할 수 있습니다.

  • Department

  • Title

  • 위치

  • 없음

  • 별칭 확인인

  • UM 다이얼 플랜에서 상속됨

MaxCallDuration

선택

System.Int32

이 매개 변수는 통화가 방해를 받거나 끊기기 전에 지속될 수 있는 최대 시간을 지정합니다. 기본값은 30분입니다.

MaxRecordingDuration

선택

System.Int32

이 매개 변수는 메시지가 녹음될 수 있는 최대 시간을 지정합니다. 여기에는 모든 종류의 통화가 포함됩니다.

이 값은 5에서 100 사이로 설정할 수 있습니다. 이 값을 너무 작은 값으로 설정하면 긴 음성 메시지가 완료되기 전에 끊길 수 있습니다. 이 값을 너무 큰 값으로 설정하면 사용자가 받은 편지함에 아주 긴 음성 메시지를 저장할 수 있습니다.

Exchange Server 2007 SP2(서비스 팩 2)의 경우 이 설정은 1부터 100 사이의 값일 수 있습니다.

Name

선택

System.String

이 매개 변수는 UM 다이얼 플랜에 사용되는 표시 이름을 지정합니다. 이 이름은 64자로 제한됩니다.

NationalNumberPrefix

선택

System.String

이 매개 변수는 시외, 국내 통화에 사용되는 전화 번호에 미리 추가되는 코드를 지정합니다. 예를 들어, 북미로 전화를 걸 때는 1이 미리 추가됩니다.

NDREnabled

선택

System.Boolean

이 매개 변수는 제출된 UM 전화 응답 메시지가 NDR(배달 못 함 보고서)을 요청할지 여부를 지정합니다. 매개 변수가 $false로 설정되면 메시지는 NDR 요청 없이 제출됩니다. 기본값은 $false입니다.

OperatorExtension

선택

System.String

이 매개 변수는 교환원 내선 번호를 지정합니다. 이 매개 변수가 지정되지 않으면 교환원에게 전송 허용 안 함 기능을 사용할 수 없습니다.

OutsideLineAccessCode

선택

System.String

이 매개 변수는 외부, 국내 통화에 사용되는 전화 번호에 미리 추가되는 코드를 지정합니다. 이 코드는 트렁크 액세스 코드라고도 합니다. 기본값은 9입니다.

PromptPublishingPoint

선택

System.String

이 매개 변수는 사용자 지정 프롬프트가 있는 서버와 공유의 Windows 파일 공유 경로를 지정합니다. 기본 경로는 UM 다이얼 플랜에 추가될 때의 첫 번째 통합 메시징 서버로 설정됩니다.

RecordingIdleTimeout

선택

System.Int32

이 매개 변수는 녹음이 종료되기 전 음성 메시지를 녹음할 때 전화를 건 사람이 침묵을 유지할 수 있는 시간을 지정합니다. 기본값은 5초입니다.

SendVoiceMsgEnabled

선택

System.Boolean

이 매개 변수는 메시지 보내기 기능의 사용 가능 여부를 지정합니다.

TUIPromptEditingEnabled

선택

System.Boolean

이 매개 변수는 권한 있는 사용자에게 TUI(전화 사용자 인터페이스)를 사용한 자동 전화 교환 확인이나 UM 다이얼 플랜 녹음이 허용되는지 여부를 지정합니다. 기본 설정은 $false입니다.

UMAutoAttendant

선택

Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter

이 매개 변수는 전화를 건 사람이 별표(*)를 누를 때 자동 전화 교환이 실행되도록 지정합니다. 이 매개 변수가 지정되면 음성 전화 걸기 기능이 다시 정의됩니다.

VoIPSecurity

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMVoIPSecurityType

이 매개 변수는 신호 채널이 MTLS를 사용하여 암호화되는지 여부를 지정합니다. 기본 설정은 UnSecured입니다.

WelcomeGreetingEnabled

선택

System.Boolean

이 매개 변수는 사용자 지정 환영 인사말의 사용 가능 여부를 지정합니다. 기본값은 $false입니다.

WelcomeGreetingFilename

선택

System.String

이 매개 변수는 환영 인사말에 사용할 오디오 파일 이름을 지정합니다.

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

첫 번째 예에서는 외부 회선 액세스 코드에 9를 사용하도록 MyUMDialPlan이라고 하는 UM 다이얼 플랜을 구성합니다.

두 번째 예에서는 환영 인사말을 사용하도록 MyUMDialPlan이라고 하는 UM 다이얼 플랜을 구성합니다.

세 번째 예에서는 전화 걸기 규칙을 사용하여 MyUMDialPlan이라고 하는 UM 다이얼 플랜을 구성합니다.

Set-UMDialPlan -Identity MyDialPlan -OutsideLineAccessCode 9

Set-UMDialPlan -Identity MyDialPlan -WelcomeGreetingEnabled $true -WelcomeGreetingFilename welcome.wav

$csv=import-csv "C:\MyInCountryGroups.csv"
Set-UMDialPlan -Identity MyDialPlan -ConfiguredInCountryGroups $csv
Set-UMDialPlan -Identity MyDialPlan -AllowedInCountryGroups "local, long distance"