New-CsRgsHoliday
Letztes Änderungsdatum des Themas: 2012-03-23
Erstellt einen neuen Reaktionsgruppenfeiertag. In der Reaktionsgruppenanwendung ist ein Feiertag ein Tag, an dem die einer Warteschleife zugewiesenen Agenten nicht arbeiten und nicht zur Anrufannahme zur Verfügung stehen, obwohl es sich um einen Wochentag handelt. Wenn beispielsweise Arbeitnehmer in den USA an Thanksgiving nicht arbeiten müssen, wird ein Feiertag für den 24. November 2011 konfiguriert.
Syntax
New-CsRgsHoliday -EndDate <Nullable> -StartDate <Nullable> [-Name <String>]
Detaillierte Beschreibung
Die Reaktionsgruppenanwendung verwendet Geschäftszeitenauflistungen, um die Wochentage und die Uhrzeiten anzugeben, an denen Agenten normalerweise zur Entgegennahme von Telefonanrufen zur Verfügung stehen. Angenommen, der Helpdesk ist montags in der Regel von 07:00 bis 19:00 Uhr erreichbar. In diesem Fall würden Sie eine Geschäftszeitenauflistung für den Helpdesk erstellen und für einen typischen Montag den Beginn der Geschäftszeit auf 07:00 Uhr und das Ende der Geschäftszeit auf 19:00 Uhr festlegen.
Zu dieser Regel kann es jedoch Ausnahmen geben. Beispielsweise ist in den USA der 4. Juli ein Nationalfeiertag. Dementsprechend ist Ihr Helpdeskpersonal am 4. Juli möglicherweise nicht verfügbar. Um zu berücksichtigen, dass der Helpdesk am Montag, den 4. Juli 2011 nicht arbeiten wird, müssen Sie einen Feiertag für diesen Tag erstellen und ihn dem Feiertagssatz des Helpdesks hinzufügen.
Zum Erstellen eines Feiertags müssen Sie das Cmdlet New-CsRgsHoliday einsetzen. (Beachten Sie, dass ein "Feiertag" nicht unbedingt bestimmte Festivitäten voraussetzt; stattdessen ist ein Feiertag einfach ein Tag, an dem keine Agenten zum Entgegennehmen von Anrufen zur Verfügung stehen.) New-CsRgsHoliday fügt einem Feiertagssatz nicht direkt einen Feiertag hinzu. Stattdessen erstellt das Cmdlet einen neuen Feiertag, der nur im Arbeitsspeicher vorhanden ist. Daher müssen Sie einen Objektverweis (wie "$x") erstellen, der auf diese nur im Arbeitsspeicher vorhandene Instanz verweist. Nachdem der Feiertag im Arbeitsspeicher erstellt wurde, verwenden Sie das Cmdlet Get-CsRgsHolidaySet zum Abrufen des entsprechenden Feiertagssatzes und das Cmdlet Set-CsRgsHolidaySet zum Hinzufügen des neuen Feiertags zu diesem Satz.
Auch wenn ein Feiertagssatz mehrere Feiertage enthalten kann (und dies in der Regel auch der Fall ist), müssen diese Feiertage dem Satz nacheinander hinzugefügt werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsRgsHoliday lokal ausführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Da dieses Cmdlet jedoch ein arbeitsspeicherinternes Objekt erstellt und selbst keine Änderungen am System durchführt, kann es praktisch von jedem Benutzer ausgeführt werden. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsHoliday\b"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Name |
Erforderlich |
Zeichenfolge |
Eindeutiger Name zum Unterscheiden des Feiertags von anderen Feiertagen. |
EndDate |
Erforderlich |
DateTime |
Enddatum des Feiertags. Das Format des Enddatums hängt von Ihren Sprach- und Regionseinstellungen ab. In den USA wird das Enddatum 4. Juli 2011 beispielsweise folgendermaßen formatiert: -EndDate "7/5/2011 12:00 AM", was bedeutet, dass der Feiertag am 5. Juli 2011 um 0:00 Uhr endet. |
StartDate |
Erforderlich |
DateTime |
Anfangsdatum des Feiertags. Das Format des Anfangsdatums hängt von Ihren Sprach- und Regionseinstellungen ab. In den USA wird das Anfangsdatum 4. Juli 2011 beispielsweise folgendermaßen formatiert: -StartDate "7/4/2011 12:00 AM", was bedeutet, dass der Feiertag am 4. Juli 2011 um 0:00 Uhr beginnt. |
Eingabetypen
Keine. New-CsRgsHoliday akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit New-CsRgsHoliday werden neue Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.Holiday" erstellt.
Beispiel
-------------------------- Beispiel 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
Die Befehle in Beispiel 1 zeigen, wie Sie einen neuen Feiertag ("Christmas Day") erstellen können, und weisen diesen einem vorhandenen Feiertagssatz zu. Hierzu erstellt der erste Befehl im Beispiel mithilfe des Cmdlets New-CsRgsHoliday einen neuen Feiertag. Dabei handelt es sich um einen virtuellen Feiertag, der nur im Arbeitsspeicher vorhanden und in der Variablen "$christmasDay" gespeichert ist. New-CsRgsHoliday verwendet drei Parameter: "StartDate", der das Anfangsdatum des Feiertags angibt (12/25/2010 12:00 AM), "EndDate", der das Enddatum des Feiertags angibt (12/26/2010 12:00 AM), und "Name", der den eindeutigen Namen des Feiertags angibt.
Nach Erstellung des neuen Feiertags ruft der zweite Befehl mithilfe von Get-CsRgsHolidaySet den Feiertagssatz "2010 Holidays" aus dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com" ab. Dieser Feiertagssatz ist in der Variablen "$y" gespeichert.
In Befehl 3 wird der neue Feiertag ($christmasDay) mithilfe der Add-Methode der virtuellen Kopie des Feiertagssatzes ($y) hinzugefügt. Der letzte Befehl ruft anschließend Set-CsRgsHolidaySet auf, um diese Änderungen in den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" zu schreiben (d. h. den neuen Feiertag hinzuzufügen).