New-CsRgsQueue
トピックの最終更新日: 2012-03-23
新しい応答グループ キューを作成します。応答グループ アプリケーションでは、通話をキューに配置して、応答グループ エージェントがその通話に応答できるようになるまで発信者を保留します。
構文
New-CsRgsQueue -Parent <RgsIdentity> -Name <String> [-AgentGroupIDList <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-OverflowAction <CallAction>] [-OverflowCandidate <NewestCall | OldestCall>] [-OverflowThreshold <Nullable>] [-TimeoutAction <CallAction>] [-TimeoutThreshold <Nullable>] [-WhatIf [<SwitchParameter>]]
解説
誰かが応答グループ アプリケーションに関連付けられた電話番号に電話をかけると、通常は次の 2 つのいずれかが発生します。1 つは、発信者が次に進むために回答する必要のある質問 (たとえば、"ハードウェア サポートについては 1 を、ソフトウェア サポートについては 2 を押してください" など) に通話を転送します。または、通話をキューに配置して、エージェントがその通話に応答できるようになるまで保留します。
すべての通話用に 1 つのキューを構成する代わりに、応答グループ アプリケーションでは複数のキューを作成して、異なるワークフローや異なる応答グループ エージェント グループに関連付けることができます。同様に、指定した数の通話がキュー内に同時に配置されているなどの状況や、指定した秒数の間保留中の発信者に対して、キューが異なる対応を実行できることを意味します。
New-CsRgsQueue コマンドレットを使用すると、管理者は新しい応答グループ キューを簡単に作成することができます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、New-CsRgsQueue コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsQueue"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Parent |
必須 |
RGS ID |
新しいキューがホストされるサービス。次に例を示します。-Parent "service:ApplicationServer:atl-cs-001.litwareinc.com" |
Name |
必須 |
文字列 |
キューに割り当てられる一意の名前。Parent プロパティと Name プロパティを一緒に使用すると、キューのグローバル一意識別子 (GUID) を参照することなく、一意に応答グループ キューを識別することができます。 |
AgentGroupIdList |
省略可能 |
AgentGroup コレクション |
キューに追加される応答グループ エージェント グループの Identity。エージェント グループの Identity は Get-CsRgsAgentGroup コマンドレットを使用して取得できます。詳細については、このトピックの「例」セクションを参照してください。 エージェント グループが割り当てられていない (またはエージェントのいないエージェント グループにのみ割り当てられている) キューに通話がルーティングされると、通話は自動的に切断されます。 |
Description |
省略可能 |
文字列 |
管理者が応答グループ キューに関する追加情報を指定できます。 |
OverflowAction |
省略可能 |
CallAction オブジェクト |
オーバーフローしきい値に到達した場合に実行されるアクション。OverflowAction は、New-CsRgsCallAction コマンドレットを使用して作成する必要があります。 |
OverflowCandidate |
省略可能 |
PS リスト修飾子 |
オーバーフローしきい値に到達した場合に、どの通話に対してアクションが実行されるかを示します。OverflowCandidate プロパティは、次の 2 つの値のどちらかに設定する必要があります。 NewestCall OldestCall 既定値は NewestCall です。 |
OverflowThreshold |
省略可能 |
整数 |
一度にキュー内に配置できる同時通話数。この値を超えると、オーバーフロー アクションが起動されます。OverflowThreshold には、0 以上 1000 以下の整数値を指定できます。既定値は null です。これは、数の制限なしに、いつでもキュー内に通話を配置できることを示します。 |
TimeoutAction |
省略可能 |
CallAction オブジェクト |
タイムアウトしきい値に到達した場合に実行されるアクション。TimeoutAction は、New-CsRgsCallAction コマンドレットを使用して作成する必要があります。 |
TimeoutThreshold |
省略可能 |
整数 |
通話がキューに配置されてからタイムアウトするまでの時間 (秒)。指定した時間を過ぎると、システムは TimeoutAction パラメーターに指定されたアクションを実行します。 タイムアウトしきい値には、10 秒以上 65535 秒 (約 18 時間) 以下の整数を指定できます。既定値は null です。これは、キューがタイムアウトしないことを示します。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
InMemory |
省略可能 |
スイッチ パラメーター |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
入力の種類
なし。New-CsRgsQueue はパイプライン処理された入力を受け入れません。
戻り値の種類
New-CsRgsQueue は、Microsoft.Rtc.Rgs.Management.WritableSettings.Queue オブジェクトの新しいインスタンスを作成します。
例
-------------------------- 例 1 ------------------------
$x = New-CsRgsCallAction -Action TransferToVoicemailUri -Uri "sip:+14255551298@litwareinc.com"
New-CsRgsQueue -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -OverflowCandidate "OldestCall" -OverflowAction $x -OverflowThreshold 25
例 1 では、ApplicationServer:atl-cs-001.litwareinc.com サービスに新しい応答グループ キューを作成します。例の最初のコマンドは、New-CsRgsCallAction コマンドレットを使用して、キューの通話アクションを作成します。この例では、オーバーフローしきい値に到達するたびに、通話は自動的にボイス メールに転送されます。これは Action パラメーターを TransferToVoicemailUri に設定し、URI プロパティをボイス メールの SIP URI "sip:+14255551298@litwareinc.com" に設定することにより構成されます。
通話アクションが構成された (さらに変数 $x に格納された) 後、New-CsRgsQueue が使用されて、Help Desk という名前の新しいキューが作成されます。OverflowAction の指定に加えて、このコマンドでは OverflowCandidate および OverflowThreshold プロパティの値も設定されます。