New-CsRgsHolidaySet
トピックの最終更新日: 2012-03-23
新しい応答グループ休日セットを作成します。応答グループ休日セットは、休日のコレクションです。たとえば、米国 (U.S.) で動作するキュー (独立記念日の休日を含むセット) に 1 つの休日セットを作成し、フランスで動作するキューに別のセットを作成します。フランスで動作するキューの場合は、フランス革命記念日に休日を定義しますが、米国の独立記念日は定義しません。
構文
New-CsRgsHolidaySet -Parent <RgsIdentity> -HolidayList <Collection> -Name <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
発信者に最高レベルのエクスペリエンスを提供するために、応答グループ アプリケーションを使用して、応答グループ エージェントが通話に応答できる時間と通話に応答できない時間を明確に定義することができます。応答グループ アプリケーションを使用すると、営業時間を定義することができます。これらの営業時間は、エージェントが電話に応答できる曜日および時間帯を示します。たとえば、組織が通常、月曜日から金曜日の午前 9 時から午後 5 時まで営業する場合、エージェントが月曜日から金曜日の午前 9 時から午後 5 時まで応答可能であること (さらには、エージェントが、たとえば木曜日の午後 8 時や日曜日の午後 2 時 30 分には応答できないこと) を示すように、営業時間を構成することになります。
ただし、多くの組織では通常の営業週に例外が生じます。たとえば、米国ではクリスマスの日または感謝祭の日に営業しない可能性があります。通常とは異なる休業日に対応するために、応答グループ アプリケーションでは特定の日を休日として指定することができます。休日とは、何らかの理由により組織が営業しない、通常は営業日である日のことです。それぞれの休日 (New-CsRgsHoliday コマンドレットを使用して作成) は休日セット内に収集されます。たとえば、米国の休日は US_Holidays という名前の休日セットに収集され、日本の休日は、Japanese_Holidays という名前の休日セットに収集されます。収集後、休日とそれに対応する休日セットは応答グループ ワークフローに割り当てることができます。
New-CsRgsHolidaySet コマンドレットを使用すると、組織内で使用するための新しい休日セットを構成することができます。新しい休日セットを作成するときには、少なくとも 1 つの休日を含める必要があります。個々の休日は New-CsRgsHoliday コマンドレットを使用して作成する必要があります。
このコマンドレットを実行できる人は次のとおりです。既定では、次のグループのメンバーが、New-CsRgsHolidaySet コマンドレットのローカルでの実行を承認されています。RTCUniversalServerAdmins です。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsHolidaySet"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
HolidayList |
必須 |
休日オブジェクト コレクション |
休日セットに追加される 1 つ以上の休日。休日は、New-CsRgsHoliday コマンドレットを使用して作成し、オブジェクト参照に格納する必要があります。その後、休日セットに休日を追加するために、Holidays パラメーターにこれらのオブジェクト参照を渡します。たとえば、次のコマンドは New Year’s Day という名前の休日を作成し、その後 $x という名前のオブジェクト参照に、この結果の値を格納します。 $x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day" 日付および時間の指定に使用する形式は、Regional および Language オプションにより異なります。このトピックで示す例は、米国の英語を使用しています。 |
Name |
必須 |
文字列 |
休日セットに割り当てられる一意の名前。Parent プロパティと Name プロパティを一緒に使用すると、休日セットのグローバル一意識別子 (GUID) を参照することなく、一意に休日セットを識別することができます。 |
Parent |
必須 |
RGS ID |
新しい休日セットがホストされるサービス。次に例を示します。-Parent "service:ApplicationServer:atl-cs-001.litwareinc.com" |
InMemory |
省略可能 |
スイッチ パラメーター |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
入力の種類
なし。New-CsRgsHolidaySet はパイプライン処理された入力を受け入れません。
戻り値の種類
New-CsRgsHolidaySet は、Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet オブジェクトの新しいインスタンスを作成します。
例
-------------------------- 例 1 ------------------------
$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day"
New-CsRgsHolidaySet -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2011 Holidays" -HolidayList($x)
例 1 のコマンドは、2011 Holidays という名前の新しい休日セットを作成してから、この休日セットに新しい休日 (New Year’s Day) を割り当てます。これを実行するために、最初のコマンドで New-CsRgsHoliday を使用し、New Year’s Day 用の休日を作成します。New-CsRgsHoliday では次の 3 つのパラメーターを使用します。StartDate は休日の開始日を示します (2011 年 1 月 1 日の午前 0 時)。EndDate は、休日の終了日を示します (2011 年 1 月 2 日の午前 0 時)。Name は、休日に割り当てる名前を格納するために使用されます。結果の休日オブジェクトは、$x 変数に格納されます。
メモリ内に新しい休日が作成された後、New-CsRgsHolidaySet を使用し、ApplicationServer:atl-cs-001.litwareinc.com サービス上に新しい休日セットを作成します。この休日セットには、2011 Holidays という名前が付けられ (-Name "2011 Holidays")、-HolidayList ($x) という指定によって、$x 変数に格納された休日が割り当てられています。この休日セットに複数の休日を割り当てる場合は、単純に複数の新しい休日を作成し、それぞれの休日を一意の変数に割り当てます。その後、これらのすべての変数名をパラメーター値として、次のように HolidayList に渡して、休日セットに含めることができます。
-HolidayList($x, $y, $z)