Topic Last Modified: 2013-02-22

Creates a new Response Group workflow. Workflows determine the actions that are taken when the Response Group application receives a phone call. This cmdlet was introduced in Lync Server 2010.

Syntax

New-CsRgsWorkflow -Name <String> -Parent <RgsIdentity> -PrimaryUri <Uri> [-Active <$true | $false>] [-Anonymous <$true | $false>] [-BusinessHoursID <RgsIdentity>] [-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>] [-Managed <$true | $false>] [-ManagersByUri <Collection>] [-NonBusinessHoursAction <CallAction>] [-TimeZone <String>] [-WhatIf [<SwitchParameter>]]

Examples

EXAMPLE 1

Example 1 creates a new workflow on the service ApplicationServer:atl-cs-001.litwareinc.com. This workflow is given the Name Help Desk and is assigned a primary URI of sip:helpdesk@litwareinc.com.

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

EXAMPLE 2

The command shown in Example 2 create a new workflow prompt and call action, then assigns those items to a new Response Group workflow. In the first command, the New-CsRgsPrompt cmdlet is used to create a text-to-speech prompt “Welcome to the help desk.” This new prompt is stored in a variable named $prompt.

The second command uses the Get-CsRgsQueue cmdlet to retrieve the Identity of an existing Response Group queue named Help Desk; the returned Identity is stored in a variable named $queue.

Command 3 then creates a new call action (stored in a variable named $callAction) that references both the new prompt ($prompt) and the retrieved queue ($queue). Finally, the last command in the example creates a new workflow named Help Desk. This command sets the PrimaryUri to sip:helpdesk@litwareinc.com and sets the value of the DefaultAction property to the call action created in the previous step.

Copy Code
$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

Detailed Description

Workflows are a key element in the Response Group application. Each workflow is uniquely associated with a phone number; when someone calls that number, the workflow determines how the call will be handled. For example, the call might be routed to a series of interactive voice response (IVR) questions that prompt the caller to enter additional information ("Press 1 for hardware support. Press 2 for software support.") Alternatively, the call might be placed in a queue and the caller placed on hold until an agent is available to answer the call. The availability of agents to answer calls is also dictated by the workflow: workflows are used to configure business hours (the days of the week and the times of day when agents are available to answer calls) and also holidays (days when no agents are available to answer calls).

New workflows are created by using the New-CsRgsWorkflow cmdlet.

Who can run this cmdlet: By default, members of the following groups are authorized to run the New-CsRgsWorkflow cmdlet: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

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

Parameters

Parameter Required Type Description

Name

Required

System.String

Unique name to be assigned to the workflow. The combination of the Parent property and the Name property enables you to uniquely identify workflows without having to refer to the workflow’s globally unique identifier (GUID).

Parent

Required

Microsoft.Rtc.Rgs.Management.RgsIdentity

Service where the new workflow will be hosted. For example: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com".

PrimaryUri

Required

System.Uri

SIP address for the workflow. For example: -PrimaryUri "sip:helpdesk@litwareinc.com". The PrimaryUri must begin with the "sip:" prefix.

Active

Optional

System.Boolean

If set to True, this means that the workflow is active and available to take phone calls. If set to False (the default value), the workflow is not available to take phone calls.

When the Active property is set to True then the workflow will be validated before it is created. For example, the workflow will not be created if a DefaultAction has not been specified. If Active is set to False (or not configured) then no validation will take place, and the workflow will be created even if a DefaultAction has not been specified.

Anonymous

Optional

System.Boolean

If set to True, the identities of individual Response Group agents will be masked any time these agents answer a call. If set to False (the default value), agent identities will be available to callers.

BusinessHoursID

Optional

Microsoft.Rtc.Rgs.Management.RgsIdentity

Days of the week and times of the day that workflow agents are available to answer calls. The business hour Identities can be retrieved by using the Get-CsRgsHoursOfBusiness cmdlet.

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command.

CustomMusicOnHoldFile

Optional

Microsoft.Rtc.Rgs.Management.WritableSettings.AudioFile

Represents custom music to be played when callers are placed on hold. (If not defined, callers will hear the default music when placed on hold.) Custom music must be imported by using the Import-CsRgsAudioFile cmdlet.

DefaultAction

Optional

Microsoft.Rtc.Rgs.Management.WritableSettings.CallAction

Indicates the action to be taken when a workflow is opened during business hours. DefaultAction must be defined by using the New-CsRgsCallAction cmdlet, and must either direct the call to a queue or to a question. The DefaultAction parameter is mandatory if the workflow is active, but can be omitted if the workflow is inactive.

Description

Optional

System.String

Enables administrators to add additional information about a Response Group workflow. For example, the Description might include contact information for the owner of the workflow. This description appears in the Lync contact card for the workflow.

DisplayNumber

Optional

System.String

Phone number for the workflow as displayed in Lync. The DisplayNumber can be formatted any way you want; for example:

-DisplayNumber "555-1219"

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

-DisplayNumber "1.425.555.1219"

EnabledForFederation

Optional

System.Boolean

Indicates whether the workflow is available to users from a federated domain. If set to False, only users within your organization will have access to the workflow.

Force

Optional

System.Management.Automation.SwitchParameter

Suppresses the display of any non-fatal error message that might occur when running the command.

HolidayAction

Optional

Microsoft.Rtc.Rgs.Management.WritableSettings.CallAction

Action to be taken if a call is received on a holiday. The HolidayAction must be defined by using the New-CsRgsCallAction cmdlet.

HolidaySetIDList

Optional

System.Collections.ObjectModel.Collection

Represents days when workflow agents are not available to answer calls. The holiday set Identities can be retrieved by using the Get-CsRgsHolidaySet cmdlet.

InMemory

Optional

System.Management.Automation.SwitchParameter

Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.

Language

Optional

System.String

Language that is used to read workflow text-to-speech prompts. The language parameter is optional as long as the operating system is using one of the supported languages shown in the list below. (Note that supported speech languages represent a subset of the languages that can be used on the operating system.)

If the operating system is not using a supported language, then the Language parameter becomes mandatory, and the parameter must specify the language code for a supported language. If your operating system is using a non-supported language on the operating system, and you run the New-CsRgsWorkflow cmdlet without including the Language parameter, your command will fail.

For example, suppose your operating system is running under the Faroese language. This language is supported by the Windows operating system, but not by the Response Group application. Therefore, you must include the Language parameter and a supported language when creating a new workflow.

This is required because, if no language is specified, the workflow uses the operating system language. However, that language can be used in a workflow only if it is a language supported by the Response Group application.

The language must be specified using one of the following language codes:

ca-ES – Catalan (Spain)

da-DK – Danish (Denmark)

de-DE – German (Germany)

en-AU – English (Australia)

en-CA – English (Canada)

en-GB – English (United Kingdom)

en-IN – English (India)

en-US – English (United States)

es-ES – Spanish (Spain)

es-MX – Spanish (Mexico)

fi-FI – Finnish (Finland)

fr-CA – French (Canada)

fr-FR – French (France)

it-IT – Italian (Italy)

ja-JP – Japanese (Japan)

ko-KR – Korean (Korea)

nb-NO – Norwegian, Bokmal (Norway)

nl-NL – Dutch (Netherlands)

pl-PL – Polish (Poland)

pt-BR – Portuguese (Brazil)

pt-PT – Portuguese (Portugal)

ru-RU – Russian (Russia)

sv-SE – Swedish (Sweden)

zh-CN – Chinese (People’s Republic of China)

zh-HK – Chinese (Hong Kong SAR)

zh-TW – Chinese (Taiwan)

For example: -Language "nl-NL".

LineUri

Optional

System.Uri

Phone number for the workflow. The line Uniform Resource Identifier (URI) must be specified by using the following format: the TEL: prefix followed by a plus sign, followed by the country/region calling code, area code, and phone number (using only digits: no blank spaces, periods, or hyphens). For example: -LineUri "TEL:+14255551219"

Managed

Optional

System.Boolean

When set to True indicates that the workflow will be managed by one or more users. Those users can be specified by using the ManagedByUri parameter.

ManagersByUri

Optional

System.Collections.ObjectModel.Collection

SIP addresses of the user (or users) who will manage the workflow. For example:

-ManagedByUri "sip:kenmyer@litwareinc.com"

To specify multiple managers separate the manager SIP addresses by using commas:

-ManagedByUri "sip:kenmyer@litwareinc.com", "sip:pilar@litwareinc.com"

NonBusinessHoursAction

Optional

Microsoft.Rtc.Rgs.Management.WritableSettings.CallAction

Action to be taken if a call is received outside the workflow’s business hours. The NonBusinessHoursAction must be defined by using the New-CsRgsCallAction cmdlet.

TimeZone

Optional

System.String

Time zone information used when determining holidays and business hours. For example: -TimeZone "Pacific Standard Time"

WhatIf

Optional

System.Management.Automation.SwitchParameter

Describes what would happen if you executed the command without actually executing the command.

Input Types

None. The New-CsRgsWorkflow cmdlet does not accept pipelined input.

Return Types

The New-CsRgsWorkflow cmdlet creates new instances of the Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow object.

See Also