次の方法で共有

  • [アーティクル]

Set-CsRgsHolidaySet

 

トピックの最終更新日: 2012-03-23

既存の応答グループ休日セットのプロパティ値を変更します。応答グループ休日セットは、休日のコレクションです。たとえば、米国 (U.S.) で動作するキュー (独立記念日の休日を含むセット) に 1 つの休日セットを作成し、フランスで動作するキューに別のセットを作成します。フランスで動作するキューの場合は、フランス革命記念日に休日を定義しますが、米国の独立記念日は定義しません。

構文

Set-CsRgsHolidaySet -Instance <HolidaySet> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

解説

発信者に最高レベルのエクスペリエンスを提供するために、応答グループ アプリケーションを使用して、応答グループ エージェントが通話に応答できる時間と通話に応答できない時間を明確に定義することができます。応答グループ アプリケーションを使用すると、営業時間を定義することができます。営業時間とは、エージェントが電話に応答できる曜日および時間帯を示します。たとえば、組織が通常、月曜日から金曜日の午前 9 時から午後 5 時まで営業する場合、エージェントが月曜日から金曜日の午前 9 時から午後 5 時まで応答可能であること (さらには、エージェントが、たとえば木曜日の午後 8 時や日曜日の午後 2 時 30 分には応答できないこと) を示すように、営業時間を構成することになります。

ただし、多くの組織では通常の営業週に例外が生じます。たとえば、米国ではクリスマスの日または感謝祭の日に営業しない可能性があります。このような通常とは異なる休業日に対応するために、応答グループ アプリケーションでは特定の日を休日として指定することができます。休日とは、何らかの理由により組織が営業しない、通常は営業日である日のことです。それぞれの休日 (New-CsRgsHoliday コマンドレットを使用して作成) は休日セット内に収集されます。たとえば、米国の休日は US_Holidays という名前の休日セットに収集され、日本の休日は、Japanese_Holidays という名前の休日セットに収集されます。休日セットは、収集後に応答グループ ワークフローに割り当てることができます。

Set-CsRgsHolidaySet コマンドレットを使用すると、既存の休日セットを変更することができます。(大部分は、セットに新しい休日を追加するか、セットから休日を削除する操作になります)。Set-CsRgsHolidaySet を直接使用して、休日セットを変更することはありません。代わりに、Get-CsRgsHolidaySet コマンドレットを使用して、既存の休日セットへのオブジェクト参照を作成します(オブジェクト参照は、この場合は、既存の休日セットを参照する変数のことです)。セットへの変更はメモリ内で実行され、その後 Set-CsRgsHolidaySet を使用して、実際の休日セットにこれらの変更を書き込みます。Set-CsRgsHolidaySet を呼び出さなければ、変更はメモリ内でのみ反映され、Windows PowerShell を閉じるかそのオブジェクト参照を削除すると、その変更は即座に消失します。

このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Set-CsRgsHolidaySet コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRgsHolidaySet"}

パラメーター

パラメーター 必須かどうか 型 説明

Instance

必須

HolidaySet オブジェクト

変更する応答グループ休日セットへのオブジェクト参照。オブジェクト参照は通常、Get-CsRgsHolidaySet コマンドレットを使用し、戻り値を変数に割り当てることで取得します。たとえば、次のコマンドは Help Desk 休日セットへのオブジェクト参照を戻し、$x という名前の変数にそのオブジェクト参照を格納します。

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"

Force

省略可能

スイッチ パラメーター

コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。

WhatIf

省略可能

スイッチ パラメーター

実際にコマンドを実行せずに、コマンドの実行結果がわかります。

Confirm

省略可能

スイッチ パラメーター

コマンドの実行前に確認メッセージを表示します。

入力の種類

Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet オブジェクトです。Remove-CsRgsHolidaySet は応答グループ休日セット オブジェクトのパイプライン処理されたインスタンスを受け入れます。

戻り値の種類

Set-CsRgsHolidaySet を実行しても、オブジェクトや値が戻されることはありません。代わりに、このコマンドレットは、Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet オブジェクトの既存のインスタンスを変更します。

例

-------------------------- 例 1 ------------------------

$x = New-CsRgsHoliday -StartDate "12/25/2010" -EndDate "12/26/2010" -Name "Christmas Day"
$y = Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
$y.HolidayList.Add($x)
Set-CsRgsHolidaySet -Instance $y

例 1 のコマンドは、新しい休日 (クリスマス) を作成し、既存の休日セットにその休日を割り当てます。これを実行するために、この例の最初のコマンドで New-CsRgsHoliday コマンドレットを使用して、新しい休日を作成しています (この休日はメモリ内のみで存在する "仮想の" 休日であり、$x 変数に格納されます)。New-CsRgsHoliday は次の 3 つのパラメーターを使用します。StartDate は休日の開始日を示します (12/25/2010)。EndDate は、休日の終了日を示します (12/26/2010)。Name は、休日に付けられる一意の名前を示します。

新しい休日の作成後、2 つ目のコマンドで Get-CsRgsHolidaySet を使用して、ApplicationServer:atl-cs-001.litwareinc.com サービスから "2010 Holidays" 休日セットを取得しています。この休日セットは、$y 変数に格納されます。

3 つ目のコマンドは Add メソッドを使用して、休日セット ($y) の仮想コピーに対して新しい休日 ($x) を追加します。この後、最後のコマンドで Set-CsRgsHolidaySet を使用して、ApplicationServer:atl-cs-001.litwareinc.com サービスにこの変更 (および新しい休日の追加) が書き込まれます。

-------------------------- 例 2 ------------------------

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "2010 Holidays"
$y = $x.HolidayList | Where-Object {$_.Name -eq "Christmas Day"}
$x.HolidayList.Remove($y)
Set-CsRgsHolidaySet -Instance $x

例 2 のコマンドは、既存の休日セットから 1 つの休日 (この場合、クリスマス) を削除します。このタスクを実行するために、この例の最初のコマンドは Get-CsRgsHolidaySet を使用して、ApplicationServer:atl-cs-001.litwareinc.com サービスから 2010 Holidays 休日セット (-Name "2010 Holidays") を取得します。この取得されたデータは、$x という名前の変数に格納されます。

2 つ目のコマンドで、取得された休日セットの HolidayList プロパティが Where-Object コマンドレットにパイプ処理されます。このコマンドレットは、Name プロパティが "Christmas Day" と等しい 1 つの休日を選択します。この 1 つの休日は、$y 変数に格納されます。

Christmas Day 休日の取得後、3 つ目のコマンドは Remove メソッドを使用して、この休日セット ($x) から Christmas Day 休日 ($y) を削除します。この後、例の最後のコマンドは Set-CsRgsHolidaySet を使用して、ApplicationServer:atl-cs-001.litwareinc.com 上にある実際の 2010 Holidays 休日セットに、この変更 (Christmas Day 休日の削除) を書き込みます。

-------------------------- 例 3 ------------------------

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "2010 Holidays"
$x.HolidayList.Clear()
Set-CsRgsHolidaySet -Instance $x

例 3 のコマンドは、ApplicationServer:atl-cs-001.litwareinc.com サービスで見つかった 2010 Holidays 休日セットから、すべての休日を削除します。これを実行するために、この例の最初のコマンドでは Get-CsRgsHolidaySet を使用して、ApplicationServer:atl-cs-001.litwareinc.com から適切な休日セットを取得します。その後、この休日セットは、$x という名前の変数に格納されます。

休日セットの取得後、Clear メソッドを使用して、HolidayList プロパティ内に格納されたすべての値を削除します。このプロパティのクリア後、例の最後のコマンドは Set-CsRgsHolidaySet コマンドレットを使用して、2010 Holidays 休日セットにこの変更を書き戻します。