New-CsRgsWorkflow

 

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

새 응답 그룹 워크플로를 만듭니다. 워크플로는 응답 그룹 응용 프로그램이 전화 통화를 수신할 때 수행되는 작업을 결정합니다.

구문

New-CsRgsWorkflow -Parent <RgsIdentity> -Name <String> -PrimaryUri <Uri> [-Active <$true | $false>] [-Anonymous <$true | $false>] [-BusinessHoursID <Nullable>] [-Confirm [<SwitchParameter>]] [-CustomMusicOnHoldFile <AudioFile>] [-DefaultAction <CallAction>] [-Description <String>] [-DisplayNumber <String>] [-EnabledForFederation <$true | $false>] [-Force <SwitchParameter>] [-HolidayAction <CallAction>] [-HolidaySetIDList <Collection>] [-InMemory <SwitchParameter>] [-Language <String>] [-LineUri <Uri>] [-NonBusinessHoursAction <CallAction>] [-TimeZone <String>] [-WhatIf [<SwitchParameter>]]

자세한 정보

워크플로는 응답 그룹 응용 프로그램의 주요 요소입니다. 각 워크플로는 한 전화 번호에만 고유하게 연결됩니다. 누군가 그 번호로 전화를 걸면 워크플로에 따라 해당 전화의 처리 방법이 결정됩니다. 예를 들어 발신자에게 추가 정보를 입력하라는 일련의 IVR(대화형 음성 응답) 질문("하드웨어 지원을 받으려면 1번을, 소프트웨어 지원을 받으려면 2번을 누르십시오.")으로 전화를 경로 지정할 수 있습니다. 또는 에이전트가 통화에 응답할 수 있을 때까지 통화가 큐에 배치되고 발신자가 통화 대기 상태에 놓일 수 있습니다. 에이전트가 통화에 응답할 수 있는지 여부도 워크플로를 통해 지정할 수 있습니다. 워크플로는 업무 시간(에이전트가 전화를 받을 수 있는 요일과 시간)과 휴일(에이전트가 전화를 받을 수 없는 요일)을 구성하기 위해 사용됩니다.

새 워크플로는 New-CsRgsWorkflow cmdlet을 사용하여 만듭니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsRgsWorkflow cmdlet을 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsWorkflow"}

매개 변수

매개 변수 필수 유형 설명

Name

필수

문자열

워크플로에 할당할 고유 이름입니다. Parent 속성과 Name 속성을 조합하면 워크플로 GUID(Globally Unique Identifier)를 참조하지 않고도 워크플로를 고유하게 식별할 수 있습니다.

Parent

필수

Rgs ID

새 워크플로를 호스팅할 서비스입니다 (예: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com").

PrimaryUri

필수

SIP 주소

워크플로의 SIP 주소입니다(예: -PrimaryUri "sip:helpdesk@litwareinc.com"). PrimaryUri는 "sip:" 접두사로 시작해야 합니다.

Active

선택

부울

True로 설정된 경우 워크플로가 활성 상태이고 전화 통화에 워크플로를 사용할 수 있음을 의미합니다. False(기본값)로 설정된 경우에는 전화 통화에 워크플로를 사용할 수 없습니다.

Active 속성을 True로 설정하면 워크플로를 만들기 전에 유효성 검사가 실행됩니다. 예를 들어 DefaultAction이 지정되어 있지 않은 경우 워크플로가 만들어지지 않습니다. 반면, Active를 False로 설정하거나 구성하지 않으면 유효성 검사가 실행되지 않으며 DefaultAction이 지정되어 있지 않은 경우에도 워크플로가 만들어집니다.

Anonymous

선택

부울

True로 설정된 경우 개별 응답 그룹 에이전트가 통화에 응답할 때마다 해당 에이전트의 ID가 마스킹되고, False(기본값)로 설정된 경우 발신자가 에이전트 ID를 확인할 수 있습니다.

BusinessHoursID

선택

업무 시간 개체

워크플로 에이전트가 통화에 응답할 수 있는 요일 및 시간입니다. 업무 시간 ID는 Get-CsRgsHoursOfBusiness cmdlet을 사용하여 검색할 수 있습니다.

CustomMusicOnHoldFile

선택

오디오 파일 개체

발신자가 통화 대기 중일 때 재생할 사용자 지정 음악을 나타냅니다. 이 매개 변수를 정의하지 않으면 발신자가 통화 대기 중일 때 기본 음악이 재생됩니다. 사용자 지정 음악은 Import-CsRgsAudioFile cmdlet을 사용하여 가져와야 합니다.

DefaultAction

필수

통화 작업 개체

업무 시간 중에 워크플로가 열린 경우 수행할 작업을 나타냅니다. DefaultAction은 New-CsRgsCallAction cmdlet을 사용하여 정의해야 하며, 통화를 큐 또는 질문으로 전달해야 합니다. 워크플로가 활성화된 경우에는 DefaultAction 매개 변수가 필수지만 비활성화된 경우에는 생략할 수 있습니다.

Description

선택

문자열

관리자가 응답 그룹 워크플로에 대한 추가 정보를 추가하는 데 사용됩니다. 예를 들어 Description은 워크플로 소유자의 연락처 정보를 포함할 수 있습니다. 이 설명은 워크플로의 Microsoft Lync 2010 대화 상대 카드에 표시됩니다.

DisplayNumber

선택

문자열

Lync 2010에 표시되는 워크플로의 전화 번호입니다. DisplayNumber 형식은 원하는 대로 설정할 수 있습니다. 예를 들면 다음과 같습니다.

-DisplayNumber "555-1219"

-DisplayNumber "1-(425)-555-1219"

-DisplayNumber "1.425.555.1219"

EnabledForFederation

선택

부울

페더레이션 도메인의 사용자가 워크플로를 사용할 수 있는지 여부를 나타냅니다. False로 설정된 경우 조직 내부의 사용자만 워크플로에 액세스할 수 있습니다.

HolidayAction

선택

통화 작업 개체

휴일에 전화를 받은 경우에 수행할 작업입니다. HolidayAction은 New-CsRgsCallAction cmdlet을 사용하여 정의해야 합니다.

HolidaySetIdList

선택

휴일 집합 개체

워크플로 에이전트가 통화에 응답할 수 없는 날짜를 나타냅니다. 휴일 집합 ID는 Get-CsRgsHolidaySet cmdlet을 사용하여 검색할 수 있습니다.

Language

선택

문자열

워크플로 텍스트 음성 변환 프롬프트를 읽는 데 사용되는 언어입니다. 운영 체제에서 아래 목록에 표시된 지원되는 언어 중 하나를 사용하는 경우 언어 매개 변수는 선택 사항입니다. 지원되는 음성 언어는 운영 체제에서 사용할 수 있는 언어의 하위 집합을 나타냅니다.

운영 체제에서 지원되는 언어를 사용하지 않는 경우 Language는 필수 매개 변수가 되며 지원되는 언어에 대한 언어 코드를 지정해야 합니다. 이 경우 Language 매개 변수를 포함하지 않고 New-CsRgsWorkflow를 실행하면 명령이 실패합니다.

예를 들어 운영 체제가 페로어로 실행되는 경우를 가정해 보겠습니다. 이 언어는 Windows 운영 체제에서 지원되지만 응답 그룹 응용 프로그램에서는 지원되지 않습니다. 따라서 새 워크플로를 만들 때 Language 매개 변수와 지원되는 언어를 포함해야 합니다.

언어를 지정하지 않으면 워크플로에서 운영 체제 언어를 사용하기 때문에 이는 필수 조건입니다. 페로어는 응답 그룹 응용 프로그램에서 지원하는 경우에만 워크플로에 사용할 수 있습니다.

다음 언어 코드 중 하나를 사용하여 언어를 지정해야 합니다.

ca-Es -카탈로니아어(스페인)

da-DK – 덴마크어(덴마크)

de-DE – 독일어(독일)

en-AU – 영어(오스트레일리아)

en-CA – 영어(캐나다)

en-GB – 영어(영국)

en-IN – 영어(인도)

en-US – 영어(미국)

es-ES – 스페인어(스페인)

es-MX – 스페인어(멕시코)

fi-FI – 핀란드어(핀란드)

fr-CA – 프랑스어(캐나다)

fr-FR – 프랑스어(프랑스)

it-IT – 이탈리아어(이탈리아)

ja-JP – 일본어(일본)

ko-KR – 한국어(대한민국)

nb-NO – 노르웨이어, 복말(노르웨이)

nl-NL – 네덜란드어(네덜란드)

pl-PL – 폴란드어(폴란드)

pt-BR – 포르투갈어(브라질)

pt-PT – 포르투갈어(포르투갈)

ru-RU – 러시아어(러시아)

sv-SE – 스웨덴어(스웨덴)

zh-CN - 중국어(중국)

zh-HK – 중국어(홍콩 특별 행정구)

zh-TW – 중국어(대만)

예: -Language "nl-NL"

LineUri

선택

문자열

워크플로의 전화 번호입니다. URI(Uniform Resource Identifier) 행은 TEL: 접두사, 더하기 기호, 국가 번호, 지역 번호, 전화 번호(공백, 마침표, 하이픈 등 없이 숫자만 사용)를 순서대로 나열하는 형식으로 지정해야 합니다(예: -LineUri "TEL:+14255551219").

NonBusinessHoursAction

선택

통화 작업 개체

워크플로 업무 시간 이외에 전화를 받은 경우에 수행할 작업입니다. NonBusinessHoursAction은 New-CsRgsCallAction cmdlet을 사용하여 정의해야 합니다.

TimeZone

선택

문자열

휴일 및 업무 시간을 결정할 때 사용되는 표준 시간대 정보입니다(예: -TimeZone "태평양 표준시").

Force

선택

스위치 매개 변수

명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다.

InMemory

선택

스위치 매개 변수

개체를 실제로 영구 변경 사항으로 커밋하지 않고 개체 참조를 만듭니다. 이 매개 변수와 함께 호출된 이 cmdlet의 결과를 변수로 할당하면 개체 참조의 속성을 변경한 후 이 cmdlet과 일치하는 Set- cmdlet을 호출하여 해당 변경 사항을 커밋할 수 있습니다.

입력 형식

없음. New-CsRgsWorkflow는 파이프라인된 입력을 허용하지 않습니다.

반환 형식

New-CsRgsWorkflow는 Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow 개체의 새 인스턴스를 만듭니다.

예제

-------------------------- 예제 1 --------------------------

New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com" 

위 명령은 ApplicationServer:atl-cs-001.litwareinc.com 서비스에 새 워크플로를 만듭니다. 이 워크플로에는 Help Desk라는 이름이 지정되고 sip:helpdesk@litwareinc.com이라는 기본 URI가 할당됩니다.

-------------------------- 예제 2 ------------------------코드 예제 추가

$prompt = New-CsRgsPrompt -TextToSpeechPrompt "Welcome to the help desk."
$queue = (Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk").Identity
$callAction = New-CsRgsCallAction -Prompt $prompt -Action TransferToQueue -QueueId $queue
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com" -DefaultAction $callAction

예제 2에 표시된 명령은 새 워크플로 프롬프트 및 통화 작업을 만들어 새 응답 그룹 워크플로에 할당합니다. 첫 번째 명령은 New-CsRgsPrompt cmdlet을 사용하여 "Welcome to the help desk"라는 텍스트 음성 변환 프롬프트를 만듭니다. 이 새 프롬프트는 $prompt 변수에 저장됩니다.

두 번째 명령은 Get-CsRgsQueue cmdlet을 사용하여 Help Desk라는 기존 응답 그룹 큐의 ID를 검색합니다. 반환된 ID는 $queue 변수에 저장됩니다.

세 번째 명령은 새 프롬프트($prompt)와 검색된 큐($queue) 둘 다를 참조하는 새 통화 작업($callAction 변수에 저장됨)을 만듭니다. 끝으로, 이 예제의 마지막 명령은 Help Desk라는 새 워크플로를 만듭니다. 이 명령은 PrimaryUri를 sip:helpdesk@litwareinc.com으로 설정하고 DefaultAction 속성 값을 이전 단계에서 만든 통화 작업으로 설정합니다.