Remove-CsRgsAgentGroup
トピックの最終更新日: 2012-05-21
既存の応答グループ エージェント グループを削除します。エージェント グループとは、応答グループ キューに割り当てられたエージェントのコレクションのことです。エージェントとは、特定のキューに転送された通話に応答するように割り当てられたユーザーのことです。
構文
Remove-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
誰かが応答グループ アプリケーションに関連付けられた電話番号に電話をかけると、このサービスは電話をかけられた番号に対応するワークフローを決定することで開始します。このワークフローの構成に基づいて、この通話は、たとえば対話型音声応答 (IVR) の質問セットにルーティングされます (ここで、発信者はあらためて "お問い合わせはハードウェア サポートに関するものですか? ソフトウェア サポートに関するものですか?" といった質問を尋ねられます)。あるいは、通話を応答グループ キューに配置して、誰かがその通話に応答できるようになるまで発信者を保留します。通話に応答するように指定された担当者がエージェントであり、エージェントを集めたグループが応答グループ エージェント グループと呼ばれています。エージェント グループはワークフローに関連付けられ、さらに類似した職務に関連付けられます。たとえば、ヘルプ デスク担当者は "Help Desk" エージェント グループにグループ化され、顧客サポート エージェントは "Customer Support" エージェント グループにグループ化されます。
新しいエージェント グループは、New-CsRgsAgentGroup コマンドレットを使用して作成されます。エージェント グループを削除する必要がある場合、Remove-CsRgsAgentGroup コマンドレットを呼び出して、これを実行できます。このコマンドレットはグループ全体、およびそのグループ内のすべてのエージェントを削除します。グループから 1 つのエージェントのみを削除したい場合は、代わりに Set-CsRgsAgentGroup コマンドレットを使用してください。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Remove-CsRgsAgentGroup コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsRgsAgentGroup"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Instance |
必須 |
AgentGroup オブジェクト |
削除するエージェント グループへのオブジェクト参照。ワークフロー オブジェクトを Remove-CsRgsAgentGroup にパイプ処理するときに、Instance パラメーターを省略できます。 Instance パラメーターを使用するには、以下のようなコマンドを使用します。 $x = Get-CsRgsAgentGroup -Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsAgentGroup -Instance $x Instance パラメーターを使用する場合、一度に削除できるのは 1 つのエージェント グループのみです。つまり、オブジェクト参照 ($x) に複数のエージェント グループ オブジェクトを含めることはできません。 |
Force |
省略可能 |
スイッチ パラメーター |
エージェント グループの削除を強制します。このパラメーターが指定されている場合は、エージェント グループがアクティブなワークフローに使用されている場合でも、警告の表示なしに削除されます。このパラメーターが指定されていない場合は、アクティブなワークフローが現在使用中のエージェント グループについては、すべて削除の確認が求められます。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup オブジェクトです。Remove-CsRgsAgentGroup は応答グループ エージェント グループ オブジェクトのパイプライン処理されたインスタンスを受け入れます。
戻り値の種類
Remove-CsRgsAgentGroup は、Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup オブジェクトの既存のインスタンスを削除します。
例
-------------------------- 例 1 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsAgentGroup
上記のコマンドは、ApplicationServer:atl-cs-001.litwareinc.com サービス上で使用するように構成された、すべての応答グループ エージェント グループを削除します。これを実行するために、このコマンドは最初に Get-CsRgsAgentGroup を使用して、ApplicationServer:atl-cs-001.litwareinc.com のすべてのエージェント グループを戻します。この後、これらのグループが Remove-CsRgsAgentGroup コマンドレットにパイプ処理され、このコマンドレットによって削除されます。
-------------------------- 例 2 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" | Remove-CsRgsAgentGroup
例 2 では、1 つの応答グループ エージェント グループが削除されます。削除されるのは、Help Desk という名前のグループです。これを実行するため、最初に Get-CsRgsAgentGroup を使用して、ApplicationServer:atl-cs-001.litwareinc.com から Help Desk エージェント グループ (-Name "Help Desk") を戻します。その後、このグループは Remove-CsRgsAgentGroup にパイプ処理されます。このコマンドレットは、サービスからこのグループを削除します。
-------------------------- 例 3 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"} | Remove-CsRgsAgentGroup
例 3 のコマンドは、ラウンド ロビン ルーティング方法を使用していない、ApplicationServer:atl-cs-001.litwareinc.com 上のすべての応答グループ エージェント グループを削除します。これを実行するために、最初に Get-CsRgsAgentGroup を呼び出して、ApplicationServer:atl-cs-001.litwareinc.com サービスで見つかったすべてのエージェント グループのコレクションを戻します。その後、このコレクションは Where-Object コマンドレットにパイプ処理され、RoutingMethod プロパティが RoundRobin と等しくない (-ne) グループのみが選択されます。その後、このフィルター処理されたコレクションは Remove-CsRgsAgentGroup にパイプ処理され、コレクション内の各項目が削除されます。