Set-UMAutoAttendant

 

적용 대상:Exchange Online, Exchange Server 2016

마지막으로 수정된 항목:2016-04-06

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

Set-UMAutoAttendant cmdlet을 사용하면 기존 UM(통합 메시징) 자동 전화 교환을 수정할 수 있습니다.

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

Set-UMAutoAttendant -Identity <UMAutoAttendantIdParameter> [-AfterHoursKeyMapping <MultiValuedProperty>] [-AfterHoursKeyMappingEnabled <$true | $false>] [-AfterHoursMainMenuCustomPromptEnabled <$true | $false>] [-AfterHoursMainMenuCustomPromptFilename <String>] [-AfterHoursTransferToOperatorEnabled <$true | $false>] [-AfterHoursWelcomeGreetingEnabled <$true | $false>] [-AfterHoursWelcomeGreetingFilename <String>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-BusinessHoursKeyMapping <MultiValuedProperty>] [-BusinessHoursKeyMappingEnabled <$true | $false>] [-BusinessHoursMainMenuCustomPromptEnabled <$true | $false>] [-BusinessHoursMainMenuCustomPromptFilename <String>] [-BusinessHoursSchedule <ScheduleInterval[]>] [-BusinessHoursTransferToOperatorEnabled <$true | $false>] [-BusinessHoursWelcomeGreetingEnabled <$true | $false>] [-BusinessHoursWelcomeGreetingFilename <String>] [-BusinessLocation <String>] [-BusinessName <String>] [-CallSomeoneEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | AddressList>] [-DomainController <Fqdn>] [-DTMFFallbackAutoAttendant <UMAutoAttendantIdParameter>] [-ForceUpgrade <SwitchParameter>] [-HolidaySchedule <MultiValuedProperty>] [-InfoAnnouncementEnabled <True | False | Uninterruptible>] [-InfoAnnouncementFilename <String>] [-Language <UMLanguage>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias | InheritFromDialPlan>] [-Name <String>] [-NameLookupEnabled <$true | $false>] [-OperatorExtension <String>] [-PilotIdentifierList <MultiValuedProperty>] [-SendVoiceMsgEnabled <$true | $false>] [-SpeechEnabled <$true | $false>] [-TimeZone <String>] [-TimeZoneName <UMTimeZone>] [-WeekStartDay <Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday>] [-WhatIf [<SwitchParameter>]]

이 예에서는 MyDTMFAA로 전달되는 UM 자동 전화 교환 MySpeechEnabledAA를 구성하고, 교환원의 내선 번호를 50100으로 설정하고, 업무 시간 후 이 내선 번호로 대체되도록 설정하고, UM 자동 전화 교환 메뉴가 재생되고 있을 때 발신자가 전화 키패드의 * 단추를 누를 경우 Outlook Voice Access 환영 인사말이 안내되도록 합니다.

Set-UMAutoAttendant -Identity MySpeechEnabledAA -DTMFFallbackAutoAttendant MyDTMFAA -OperatorExtension 50100 -AfterHoursTransferToOperatorEnabled $true -StaroutToDialPlanEnabled $true

이 예에서는 업무 시간이 10:45 - 13:15(일요일), 09:00 - 17:00(월요일), 09:00 - 16:30(토요일)으로 구성되고 휴일 및 연결된 인사말이 2013년 1월 2일의 경우 "New Year", 2013년 4월 24일 - 2013년 4월 28일의 경우 "Building Closed for Construction"으로 구성되어 있는 UM 자동 전화 교환 MyUMAutoAttendant를 구성합니다.

Set-UMAutoAttendant -Identity MyUMAutoAttendant -BusinessHoursSchedule 0.10:45-0.13:15,1.09:00-1.17:00,6.09:00-6.16:30 -HolidaySchedule "New Year,newyrgrt.wav,1/2/2013","Building Closed for Construction,construction.wav,4/24/2013,4/28/2013"

이 예에서는 자동 전화 교환 MyAutoAttendant를 구성하고, 발신자가 1을 누를 경우 SalesAutoAttendant라는 다른 UM 자동 전화 교환에 전달되도록 업무 시간 키 매핑을 설정합니다. 2를 누르면 지원을 위해 내선 번호 12345로 전달되고, 3을 누르면 오디오 파일을 재생하는 다른 자동 전화 교환으로 보내집니다.

Set-UMAutoAttendant -Identity MyAutoAttendant -BusinessHoursKeyMappingEnabled $true -BusinessHoursKeyMapping "1,Sales,,SalesAutoAttendant","2,Support,12345","3,Directions,,,directions.wav"

Set-UMAutoAttendant cmdlet은 기존 UM 자동 전화 교환의 설정을 변경하거나 수정합니다. 일부 UM 자동 전화 교환 매개 변수는 필수 매개 변수이고 기본적으로 생성됩니다. 하지만 UM 자동 전화 교환을 만든 다음에는 UM 자동 전화 교환의 일부 속성에 쓰기를 수행할 수 없습니다. 따라서 UM 자동 전화 교환의 일부 값은 UM 자동 전화 교환을 삭제하고 새 UM 자동 전화 교환을 만들지 않는 경우 변경하거나 수정할 수 없습니다.

이 작업을 완료하면 지정된 매개 변수와 값이 UM 자동 전화 교환에 구성됩니다.

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

 

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter

Identity 매개 변수는 표시되는 UM 자동 전화 교환의 식별자를 지정합니다. 이 매개 변수는 UM 자동 전화 교환에 대한 디렉터리 개체 ID입니다.

AfterHoursKeyMapping

옵션

Microsoft.Exchange.Data.MultiValuedProperty

AfterHoursKeyMapping 매개 변수는 업무 시간 이후 UM 자동 전화 교환에 대해 사용할 키 매핑을 지정합니다. 키 매핑은 표에서 최대 9개까지의 항목으로 정의됩니다. 0 키는 운영자 전송용으로 예약되어 있습니다.

두 개의 항목이 있는 사용자 지정 테이블의 예는 다음과 같습니다.

"Sales, 77899","Service, 78990".

기본값은 disabled입니다.

AfterHoursKeyMappingEnabled

선택

System.Boolean

AfterHoursKeyMappingEnabled 매개 변수는 업무 시간 이후 UM 자동 전화 교환에 대해 키 매핑을 사용할지 여부를 지정합니다. 키 매핑은 표에서 최대 9개까지의 항목으로 정의됩니다. 0 키는 운영자 전송용으로 예약되어 있습니다.

두 개의 항목이 있는 사용자 지정 테이블의 예는 다음과 같습니다.

"Sales, 77899","Service, 78990".

AfterHoursMainMenuCustomPromptEnabled

선택

System.Boolean

AfterHoursMainMenuCustomPromptEnabled 매개 변수는 업무 시간 이후 사용자 지정 주 메뉴를 사용할지 여부를 지정합니다. 기본값은 disabled입니다.

AfterHoursMainMenuCustomPromptFilename

선택

System.String

AfterHoursMainMenuCustomPromptFilename 매개 변수는 업무 시간 이후 사용자 지정 주 메뉴 음성 안내에 사용할 .wav 파일을 지정합니다.

AfterHoursTransferToOperatorEnabled

선택

System.Boolean

AfterHoursTransferToOperatorEnabled 매개 변수는 업무 시간 이후 전화가 교환원의 내선 번호에 전송될 수 있도록 할지 여부를 지정합니다.

AfterHoursWelcomeGreetingEnabled

선택

System.Boolean

AfterHoursWelcomeGreetingEnabled 매개 변수는 업무 시간 이후 인사말을 사용할지 여부를 지정합니다. 이 매개 변수를 disabled로 설정하면 시스템 기본 오디오가 사용됩니다. 기본값은 disabled입니다.

AfterHoursWelcomeGreetingFilename

선택

System.String

AfterHoursWelcomeGreetingFilename 매개 변수는 업무 시간 이후 인사말 메시지에 사용할 .wav 파일을 지정합니다.

AllowDialPlanSubscribers

선택

System.Boolean

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

AllowedInCountryOrRegionGroups

옵션

Microsoft.Exchange.Data.MultiValuedProperty

AllowedInCountryOrRegionGroups 매개 변수는 허용되는 국내/지역 다이얼 그룹 이름 목록을 지정합니다. 이름은 다이얼 플랜에 정의된 그룹 이름과 일치해야 합니다. 문자열은 128자 미만이어야 합니다.

AllowedInternationalGroups

옵션

Microsoft.Exchange.Data.MultiValuedProperty

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

AllowExtensions

선택

System.Boolean

AllowExtensions 매개 변수는 호출자가 다이얼 플랜 개체에 지정된 번호와 동일한 자릿수의 내선 번호로 전화를 걸 수 있는지 여부를 지정합니다. 기본값은 $false입니다.

BusinessHoursKeyMapping

옵션

Microsoft.Exchange.Data.MultiValuedProperty

BusinessHoursKeyMapping 매개 변수는 업무 시간 UM 자동 전화 교환에 사용할 키 매핑을 지정합니다. 키 매핑은 표에서 최대 9개까지의 항목으로 정의됩니다. 0 키는 운영자 전송용으로 예약되어 있습니다.

두 개의 항목이 있는 사용자 지정 테이블의 예는 다음과 같습니다.

"Sales, 77899","Service, 78990".

기본값은 disabled입니다.

BusinessHoursKeyMappingEnabled

선택

System.Boolean

BusinessHoursKeyMappingEnabled 매개 변수는 업무 시간 사용자 지정 메뉴를 사용할지 여부를 지정합니다. 기본값은 disabled입니다.

BusinessHoursMainMenuCustomPromptEnabled

선택

System.Boolean

BusinessHoursMainMenuCustomPromptEnabled 매개 변수는 업무 시간 사용자 지정 주 메뉴 음성 안내를 사용할지 여부를 지정합니다. 기본값은 disabled입니다.

BusinessHoursMainMenuCustomPromptFilename

선택

System.String

BusinessHoursMainMenuCustomPromptFilename 매개 변수는 업무 시간 사용자 지정 주 메뉴 음성 안내에 사용할 .wav 파일을 지정합니다.

BusinessHoursSchedule

선택

Microsoft.Exchange.Common.ScheduleInterval[]

BusinessHoursSchedule 매개 변수는 업무 시간을 지정합니다.

BusinessHoursTransferToOperatorEnabled

선택

System.Boolean

BusinessHoursTransferToOperatorEnabled 매개 변수는 업무 시간 전화가 교환원의 내선 번호에 전송될 수 있도록 할지 여부를 지정합니다.

BusinessHoursWelcomeGreetingEnabled

선택

System.Boolean

BusinessHoursWelcomeGreetingEnabled 매개 변수는 업무 시간 사용자 지정 인사말을 사용할지 여부를 지정합니다. 이 매개 변수를 disabled로 설정하면 시스템 기본 오디오가 사용됩니다. 기본값은 disabled입니다.

BusinessHoursWelcomeGreetingFilename

선택

System.String

BusinessHoursWelcomeGreetingFilename 매개 변수는 환영 메시지에 사용할 .wav 파일을 지정합니다.

BusinessLocation

선택

System.String

BusinessLocation 매개 변수는 사서함 서버가 UM 자동 전화 교환 메뉴에서 비즈니스 위치 옵션을 선택한 발신자에게 안내해야 하는 내용을 지정합니다.

BusinessName

선택

System.String

BusinessName 매개 변수는 발신자에 대한 UM 자동 전화 교환 환영 인사말을 생성하는 데 사용되는 회사 또는 조직의 이름을 지정합니다.

CallSomeoneEnabled

선택

System.Boolean

CallSomeoneEnabled 매개 변수는 전화 걸기 기능을 사용할지 여부를 지정합니다. 기본값은 $true입니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

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

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

ContactAddressList

선택

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

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

ContactRecipientContainer

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

ContactRecipientContainer 매개 변수는 디렉터리 검색에 사용되는 컨테이너의 이름 또는 ID를 지정합니다.

ContactScope

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialScopeEnum

ContactScope 매개 변수는 UM 자동 전화 교환에 액세스하고 사용자 이름을 지정할 때 발신자에게 제공되는 디렉터리 검색 범위를 지정합니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

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

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

DTMFFallbackAutoAttendant

선택

Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter

DTMFFallbackAutoAttendant 매개 변수는 음성 사용이 가능한 자동 전화 교환을 사용할 수 없는 경우에 사용되는 DTMF(복합 주파수 부호) 자동 전화 교환을 지정합니다. SpeechEnabled 매개 변수를 $true로 설정하면 이 자동 전화 교환에 대체 시스템 자동 전화 교환으로 사용할 연결된 DTMF 자동 전화 교환이 있어야 합니다.

ForceUpgrade

선택

System.Management.Automation.SwitchParameter

ForceUpgrade 스위치는 UM 자동 전화 교환 개체가 업그레이드되기 전에 확인 메시지를 표시할지 여부를 지정합니다.

HolidaySchedule

옵션

Microsoft.Exchange.Data.MultiValuedProperty

HolidaySchedule 매개 변수는 조직의 휴일 일정을 지정합니다. 일정 형식은 문자열 배열로 지정됩니다. 각 문자열에는 다음 3가지 부분이 포함됩니다.

  • 64자로 제한되는 이름

  • 오디오 음성 안내에 사용되는 .wav 형식의 파일 이름

  • 휴일(날짜)

예를 들면 다음과 같습니다.

"Christmas, Christmas.wav, 12/25/2013"

InfoAnnouncementEnabled

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum

InfoAnnouncementEnabled 매개 변수는 정보 인사말을 사용할지 여부를 지정합니다. 기본 설정은 $true입니다.

InfoAnnouncementFilename

선택

System.String

InfoAnnouncementFilename 매개 변수는 정보 알림에 사용할 .wav 파일을 지정합니다.

Language

선택

Microsoft.Exchange.Data.UMLanguage

Language 매개 변수는 UM 자동 전화 교환에서 사용되는 언어를 지정합니다. 이 언어는 사용 가능한 다이얼 플랜 언어 목록에서 선택됩니다.

MatchedNameSelectionMethod

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.AutoAttendantDisambiguationFieldEnum

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

  • 부서

  • 직함

  • 위치

  • 없음

  • 별칭 확인

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

Name

선택

System.String

Name 매개 변수는 UM 자동 전화 교환에 사용할 표시 이름을 지정합니다. 이 이름은 64자로 제한됩니다.

NameLookupEnabled

옵션

System.Boolean

NameLookupEnabled 매개 변수는 발신자가 이름으로 전화를 걸거나 이름을 말하는 방식으로 디렉터리 조회를 수행할 수 있도록 할지 여부를 지정합니다. 이 매개 변수는 호출자가 알려지지 않은 내선 번호에 연결하는 것을 방지할 수 있습니다.

OperatorExtension

선택

System.String

OperatorExtension 매개 변수는 운영자 내선 번호를 지정합니다. 이 매개 변수를 지정하지 않으면 다이얼 플랜 교환원이 사용됩니다. 다이얼 플랜 교환원을 지정하지 않으면 이 기능을 사용할 수 없습니다.

PilotIdentifierList

옵션

Microsoft.Exchange.Data.MultiValuedProperty

PilotIdentifierList 매개 변수는 파일럿 번호가 하나 이상 포함된 목록을 지정합니다. 파일럿 번호는 들어오는 호출을 사서함 서버로 라우팅하는 데 사용됩니다. 그런 다음 UM 자동 전화 교환에서 호출에 응답합니다.

SendVoiceMsgEnabled

선택

System.Boolean

SendVoiceMsgEnabled 매개 변수는 메시지 보내기 기능을 허용할지 여부를 지정합니다.

SpeechEnabled

선택

System.Boolean

SpeechEnabled 매개 변수는 자동 전화 교환에서 음성을 사용할 수 있는지 여부를 지정합니다. UM 자동 전화 교환에 대한 기본 설정은 $false입니다.

TimeZone

선택

System.String

Timezone 매개 변수는 자동 전화 교환에 사용되는 표준 시간대를 지정합니다. 기본 표준 시간대는 서버의 표준 시간대 설정입니다.

TimeZoneName

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMTimeZone

TimeZoneName 매개 변수는 Microsoft Windows 표준 시간대 표시 이름의 일부 또는 전체를 지정합니다. 이 문자열을 로컬 시스템 레지스트리에 있는 표시 이름과 비교하여 간단한 포함 일치 항목을 확인합니다. 표준 시간대 이름이 올바르지 않으면 오류가 반환됩니다.

WeekStartDay

선택

System.DayOfWeek

WeekStartDay 매개 변수는 주의 시작 요일을 지정합니다. 이 매개 변수에 유효한 값은 Sunday, Monday, Tuesday, Wednesday, Thursday, FridaySaturday입니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

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

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

 
표시: