New-CsRgsCallAction
トピックの最終更新日: 2012-03-23
新しい応答グループ通話アクションを作成します。応答グループ アプリケーションは通話アクションを使用して、通話の受信時におけるシステムの動作を決定します。たとえば、通話アクションには、通話を他のキューに転送する、特定の応答グループ質問を尋ねる、通話を終了するといった動作を指定します。
構文
New-CsRgsCallAction -Action <Nullable> [-Prompt <Prompt>] [-Question <Question>] [-QueueID <Nullable>] [-Uri <String>]
解説
誰かが応答グループ アプリケーションに関連付けられた電話番号に電話をかけると、このアプリケーションは電話をかけられた番号に対応するワークフローを調べます。ワークフローが見つかった後、このサービスは、通話が営業時間外または休日に受信されたのかどうかを確認します。該当する場合は、このサービスは、営業時間外または休日に受信した通話に対して指定されているアクションを実行します (たとえば、通話が直接ボイスメールに転送されます)。通話が営業時間内に受信された場合は、応答グループ アプリケーションは、営業時間内に受信された通話に対してあらかじめ設定されているアクションを実行します。これらすべてのアクションは事前に決定され、New-CsRgsCallAction コマンドレットを使用して作成されます。New-CsRgsCallAction を使用すると、応答グループ キューに通話を配置したり、ボイスメール、SIP アドレスまたは公衆交換電話網 (PSTN) の電話番号へ通話を転送したり、対話型音声応答 (IVR) の質問へ通話を転送したり、通話を終了したりできます。
New-CsRgsCallAction を使用するときに、ワークフロー、キューまたはその他の応答グループ アプリケーション要素のプロパティが直接変更されることはありません。代わりに、作成する新しい通話アクションは、当初はメモリ内にのみ存在します。このため、オブジェクト参照変数 ($x など) に格納する必要があります。その後、何か (ワークフローの DefaultAction プロパティなど) を変更するときに、適切なプロパティにオブジェクト参照を割り当てます。次に例を示します。
-DefaultAction $x
DefaultAction プロパティに割り当てることができるのは、TransferToQueue と TransferToQuestion の 2 つの通話アクションのみであることに注意してください。TransferToQueue と TransferToQuestion を除くすべての通話アクションは、休日または営業時間外に実行するアクションで有効です。さらに、TransferToQuestion を除くすべての通話アクションは、キューのタイムアウトおよびオーバーフローに使用することができます。
このコマンドレットを実行できる人は次のとおりです。既定では、次のグループのメンバーが、New-CsRgsCallAction コマンドレットのローカルでの実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins です。しかし、このコマンドレットはメモリ内のオブジェクトを作成し、自身ではシステムを変更することはないため、基本的には誰でも実行することができます。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsCallAction"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Action |
必須 |
PS リスト修飾子 |
実行する通話アクションを示します。Action は、次のいずれかの値に設定する必要があります。 Terminate - 通話が終了されます。 TransferToQueue - 通話が応答グループ キューに転送されます。 TransferToQuestion - 通話が応答グループ質問に転送されます。 TransferToUri – 通話が指定された SIP Uniform Resource Identifier (URI) に転送されます。 TransferToVoiceMailUri – 通話がボイスメールに転送されます。 TransferToPSTN – 通話が公衆交換電話網 (PSTN) の電話に転送されます。 新しい通話アクションを作成するたびに Action を指定する必要があります。Action に既定値はありません。 |
Prompt |
省略可能 |
Prompt オブジェクト |
通話アクションの実行前に再生される音声ガイダンス。("通話を転送中です。しばらくお待ちください" など)音声ガイダンスは New-CsRgsPrompt コマンドレットを使用して作成する必要があります。 |
Question |
省略可能 |
Question オブジェクト |
Action を TransferToQuestion に設定した場合に尋ねられる質問。質問は New-CsRgsQuestion コマンドレットを使用して作成する必要があります。 Action を TransferToQuestion に設定した場合、このパラメーターは必須です。 |
QueueID |
省略可能 |
Xds Identity |
通話が転送される応答グループ キューの ID (Action を TransferToQueue に設定していることが前提となります)。Get-CsRgsQueue を使用して関連するキューの Identity を取得することで、この QueueID を指定できます。 Action を TransferToQueue に設定する場合、このパラメーターは必須です。 |
Uri |
省略可能 |
文字列 |
通話が転送される SIP アドレス、ボイスメール URI または PSTN 電話番号。 Action を TransferToUri、TransferToVoiceMailUri または TransferToPSTN に設定した場合、このパラメーターは必須です。 |
入力の種類
なし。New-CsRgsCallAction はパイプライン処理された入力を受け入れません。
戻り値の種類
New-CsRgsCallAction は、Microsoft.Rtc.Rgs.Management.WritableSettings.CallAction オブジェクトの新しいインスタンスを作成します。
例
-------------------------- 例 1 ------------------------
$x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Overflow"
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $x.Identity
$z.OverflowAction = $y
Set-CsRgsQueue $z
例 1 に示すコマンドは、新しい応答グループ通話アクションを作成し、次にそのアクションを既存の応答グループ キューに割り当てる方法を示しています。この場合、通話アクションは、キューがオーバーフローに到達した場合の動作を決定します。このタスクを実行するため、最初に Get-CsRgsQueue を使用して、ApplicationServer:atl-cs-001.litwareinc.com から応答グループ アプリケーション キューの Help Desk Overflow キューを取得しています。このキューの情報は $x という名前の変数に格納されます。次に、同様のコマンドを使用して、Help Desk キューを取得し、その情報は $z という名前の変数に格納されます。
キューの取得後、New-CsRgsPrompt コマンドレットを使用して、新しい通話アクションに伴う音声合成による音声ガイダンスを作成します。この新しい通話アクションは New-CsRgsCallAction コマンドレットを実行して作成されます。この通話アクションには次の 3 つのパラメーターが割り当てられています。Prompt (通話アクションが使用する音声ガイダンス)、Action (新しい通話アクションが起動された場合の動作を示すもの。TransferToQueue パラメーター値は、この通話が別の応答グループ キューに転送されることを表します)、および QueueID (着信の転送先となる代替キュー。$x.Identity は、Help Desk Overflow キューの Identity を示しています) です。この新しい通話アクションはメモリ内で作成され、$y という名前の変数に格納されています。
通話アクションの作成後、Help Desk キューに新しい通話アクションを割り当てることができます。これは、OverflowAction プロパティの値を $y に設定することで実行されます。$y は、新しく作成された通話アクションを格納している変数です。Help Desk キューが "オーバーフロー" (つまり、許可された発信者の最大数に到達) すると、以降の通話は自動的に Help Desk Overflow キューに転送されます。
最後に、この例の最後のコマンドが Set-CsRgsQueue を呼び出し、ApplicationServer:atl-cs-001.litwareinc.com 上にある実際の Help Desk Overflow キューのインスタンスにこの変更が書き込まれます。
-------------------------- 例 2 ------------------------
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToPSTN -Uri "sip:+14255551298@litwareinc.com"
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue"
$z.OverflowAction = $y
Set-CsRgsQueue $z
例 2 のコマンドは、例 1 のコマンドと似ています。ただし例 2 では、新しい通話アクションにより、通話は PSTN の電話番号に転送されます。これを行うために、新しい通話アクションの Action プロパティを TransferToPSTN に設定し、Uri プロパティを "sip:+14255551298@litwareinc.com" に設定します。