New-CsRgsHoliday
トピックの最終更新日: 2012-03-23
新しい応答グループ休日を作成します。応答グループ アプリケーションで、休日とは、キューに割り当てられた通常であれば出勤予定のエージェントが出社せず、通話に応答できない日を意味します。たとえば、米国 (U.S.) で作業をする担当者が感謝祭の日に休日を取得する場合、休日は 2011 年 11 月 24 日に設定されます。
構文
New-CsRgsHoliday -EndDate <Nullable> -StartDate <Nullable> [-Name <String>]
解説
応答グループ アプリケーションは、エージェントが通常電話に応答できる曜日および時間帯を示すために、営業時間コレクションを使用します。たとえば、ヘルプ デスクには通常、毎週月曜日の午前 7 時から午後 7 時までスタッフが配置されているとします。この場合、ヘルプ デスクの営業時間コレクションを作成し、通常の月曜日に対して開始時間を午前 7 時に、終了時間を午後 7 時に設定します。
しかし、ヘルプ デスクに毎週月曜日の午前 7 時から午後 7 時までスタッフを配置するというルールに、例外が生じることもあります。たとえば、米国 7 月 4 日は休日のため、ヘルプ デスク担当者が 7 月 4 日に出勤しないとします。ヘルプ デスクが 2011 年 7 月 4 日の月曜日に出勤しない状況を明らかにするために、この日に対して休日を作成し、ヘルプ デスクに追加する必要があります。
休日を作成するには、New-CsRgsHoliday コマンドレットを使用する必要があります ("休日" は必ずしも、記念日や祭典などが関係するとは限りません。休日は単にエージェントが電話に応答できない日を示します)。New-CsRgsHoliday は、休日セットに休日を直接追加しません。代わりに、このコマンドレットは、メモリ内にのみ存在する新しい休日を作成します。このため、このメモリ内インスタンスを参照するオブジェクト参照 ($x など) を作成する必要があります。メモリ内に休日が作成された後、Get-CsRgsHolidaySet コマンドレットを使用して適切な休日セットを取得し、Set-CsRgsHolidaySet コマンドレットを使用してこの休日セットに新しい休日を追加します。
休日セットは複数の休日を保持することができます (また、通常は保持します) が、休日セットへの休日の追加は 1 回につき 1 つずつ実行する必要があります。
このコマンドレットを実行できる人は次のとおりです。既定では、次のグループのメンバーが、New-CsRgsHoliday コマンドレットのローカルでの実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins です。しかし、このコマンドレットはメモリ内のオブジェクトを作成し、自身ではシステムを変更することはないため、基本的には誰でも実行することができます。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsHoliday\b"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Name |
必須 |
文字列 |
この休日を他の休日と区別するために使用される一意の名前。 |
EndDate |
必須 |
DateTime |
休日の終了日。終了日の形式は、使用する Regional および Language オプションによって異なります。たとえば、米国で 2011 年 7 月 4 日の終了日は次のような形式になります。-EndDate "7/5/2011 12:00 AM"、これは 2011 年 7 月 5 日の午前 0 時に休日が終了することを示しています。 |
StartDate |
必須 |
DateTime |
休日の開始日。開始日の形式は、使用する Regional および Language オプションによって異なります。たとえば、米国で 2011 年 7 月 4 日の開始日は次のような形式になります。-StartDate "7/4/2011 12:00 AM"、これは 2011 年 7 月 4 日の午前 0 時に休日が開始することを示しています。 |
入力の種類
なし。New-CsRgsHoliday はパイプライン処理された入力を受け入れません。
戻り値の種類
New-CsRgsHoliday は、Microsoft.Rtc.Rgs.Management.WritableSettings.Holiday オブジェクトの新しいインスタンスを作成します。
例
-------------------------- 例 1 ------------------------
$christmasDay = New-CsRgsHoliday -StartDate "12/25/2010 12:00 AM" -EndDate "12/26/2010 12:00 AM" -Name "Christmas Day"
$y = Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
$y.HolidayList.Add($christmasDay)
Set-CsRgsHolidaySet -Instance $y
例 1 のコマンドは、新しい休日 (Christmas Day) を作成し、既存の休日セットにその休日を割り当てる方法を示しています。これを実行するために、この例の最初のコマンドで New-CsRgsHoliday コマンドレットを使用して、新しい休日を作成しています。この休日はメモリ内のみで存在する "仮想の" 休日であり、$christmasDay 変数に格納されます。New-CsRgsHoliday は次の 3 つのパラメーターを使用します。StartDate は休日の開始日を示します (12/25/2010 12:00 AM)。EndDate は、休日の終了日を示します (12/26/2010 12:00 AM)。Name は、休日に付けられた一意の名前を示します。
新しい休日の作成後、2 つ目のコマンドで Get-CsRgsHolidaySet を使用して、ApplicationServer:atl-cs-001.litwareinc.com サービスから "2010 Holidays" 休日セットを取得しています。この休日セットは、$y 変数に格納されます。
3 つ目のコマンドでは Add メソッドを使用して、休日セット ($y) の仮想コピーに対して新しい休日 ($christmasDay) を追加しています。この後、最後のコマンドで Set-CsRgsHolidaySet を使用して、ApplicationServer:atl-cs-001.litwareinc.com サービスにこの変更 (つまり新しい休日の追加) が書き込まれます。