Freigeben über

  • Artikel

Set-CsRgsHolidaySet

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ändert die Eigenschaftswerte eines vorhandenen Feiertagssatzes für Reaktionsgruppen. Ein Feiertagssatz für Reaktionsgruppen ist eine Auflistung von Feiertagen. Sie können beispielsweise einen Feiertagssatz für eine US-basierte Warteschleife (der z. B. den Unabhängigkeitstag am 4. Juli umfasst) und einen anderen Satz für eine Warteschleife in Frankreich verwenden. Für die französische Warteschleife könnte dann der französische Nationalfeiertag (14. Juli), nicht aber der amerikanische Unabhängigkeitstag definiert sein.

Syntax

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

Detaillierte Beschreibung

Um Anrufern ein optimales Anruferlebnis zu bieten, können Sie mit der Reaktionsgruppenanwendung genau definieren, wann Reaktionsgruppenagenten für die Entgegennahme von Anrufen zur Verfügung stehen. Die Reaktionsgruppenanwendung ermöglicht das Definieren von Geschäftszeiten, die angeben, an welchen Wochentagen und zu welchen Uhrzeiten die Agenten erreichbar sind. Wenn die üblichen Geschäftszeiten Ihrer Organisation montags bis freitags von 09:00 bis 17:00 Uhr sind, konfigurieren Sie die Geschäftszeiten so, dass die Agenten montags bis freitags von 09:00 bis 17:00 Uhr als verfügbar angezeigt werden (und demzufolge donnerstags um 08:00 Uhr oder sonntags um 14:30 Uhr nicht erreichbar sind).

In vielen Organisationen gibt es allerdings Ausnahmen für die typische Arbeitswoche. Eine Organisation in den USA ist z. B. möglicherweise nur Weihnachten und Thanksgiving geschlossen. Um diese Daten zu berücksichtigen, können Sie mit der Reaktionsgruppenanwendung bestimmte Tage als Feiertage definieren: Hierbei handelt es sich um Tage, an denen die Organisation normalerweise geöffnet wäre, jedoch aus einem bestimmten Grund geschlossen ist. Einzelne (mit dem Cmdlet New-CsRgsHoliday erstellte) Feiertage werden in Feiertagssätzen zusammengefasst. US-amerikanische Feiertage könnten beispielsweise im Feiertagssatz "US_Holidays", japanische Feiertage dagegen im Feiertagssatz "Japanese_Holidays" zusammengefasst werden. Diese Feiertagssätze können dann Reaktionsgruppenworkflows zugewiesen werden.

Das Cmdlet Set-CsRgsHolidaySet bietet eine Möglichkeit zum Ändern eines bestehenden Feiertagssatzes. (In den meisten Fällen dient es zum Hinzufügen oder Entfernen von Feiertagen aus dem Satz.) Mit Set-CsRgsHolidaySet wird ein Feiertagssatz nicht direkt geändert. Vielmehr wird mithilfe des Cmdlets Get-CsRgsHolidaySet ein Objektverweis auf einen bestehenden Feiertagssatz erstellt. (Ein Objektverweis ist eine Variable, die in diesem Fall auf einen bestehenden Feiertagssatz verweist.) Änderungen am Satz werden im Arbeitsspeicher vorgenommen. Diese werden anschließend mithilfe von Set-CsRgsHolidaySet in den eigentlichen Feiertagssatz geschrieben. Wenn Sie Set-CsRgsHolidaySet nicht aufrufen, sind die Änderungen nur im Arbeitsspeicher vorhanden und gehen verloren, sobald Sie Windows PowerShell beenden oder die Objektreferenzvariable löschen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsRgsHolidaySet lokal ausführen: RTCUniversalServerAdmins. 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 "Set-CsRgsHolidaySet"}

Parameter

Parameter Erforderlich Typ Beschreibung

Instance

Erforderlich

HolidaySet-Objekt

Objektverweis auf den zu ändernden Feiertagssatz für Reaktionsgruppen. Ein Objektverweis wird normalerweise mithilfe des Cmdlets Get-CsRgsHolidaySet und durch Zuweisen des zurückgegebenen Werts zu einer Variablen abgerufen. Mit diesem Befehl wird beispielsweise ein Objektverweis auf den Feiertagsatz "Help Desk" zurückgegeben und dieser Objektverweis in der Variablen "$x" gespeichert:

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

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet-Objekt Remove-CsRgsHolidaySet akzeptiert weitergeleitete Objektinstanzen des Feiertagssatzes für Reaktionsgruppen.

Rückgabetypen

Set-CsRgsHolidaySet gibt keine Objekte oder Werte zurück. Stattdessen werden mit dem Cmdlet bestehende Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet" geändert.

Beispiel

-------------------------- Beispiel 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

Die Befehle in Beispiel 1 erstellen einen neuen Feiertag ("Christmas Day") 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 "$x" gespeichert ist. New-CsRgsHoliday verwendet drei Parameter: "StartDate", der das Anfangsdatum des Feiertags angibt (12/25/2010), "EndDate", der das Enddatum des Feiertags angibt (12/26/2010), und "Name", der den eindeutigen Namen des Feiertags angibt.

Nach der 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 ($x) 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).

-------------------------- Beispiel 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

Die Befehle in Beispiel 2 entfernen einen Feiertag (in diesem Fall "Christmas Day") aus einem bestehenden Feiertagssatz. Hierzu ruft der erste Befehl im Beispiel mithilfe von Get-CsRgsHolidaySet den Feiertagssatz "2010 Holidays" (-Name "2010 Holidays") aus dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com" ab. Die abgerufenen Daten werden in der Variablen "$x" gespeichert.

Im zweiten Befehl wird die Eigenschaft "HolidayList" aus dem abgerufenen Feiertagssatz an das Cmdlet Where-Object weitergeleitet, das nur einen Feiertag auswählt, dessen Eigenschaft "Name" den Wert "Christmas Day" aufweist. Dieser einzelne Feiertag ist in der Variablen "$y" gespeichert.

Nachdem der Feiertag "Christmas Day" abgerufen wurde, verwendet Befehl 3 die Remove-Methode, um den Feiertag "Christmas Day" ($y) aus dem Feiertagssatz ($x) zu entfernen. Der letzte Befehl im Beispiel speichert diese Änderungen dann mithilfe von Set-CsRgsHolidaySet, um den Feiertag "Christmas Day" aus dem eigentlichen Feiertagssatz "2010 Holidays" für "ApplicationServer:atl-cs-001.litwareinc.com" zu entfernen.

-------------------------- Beispiel 3 --------------------------

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

Die Befehle in Beispiel 3 löschen alle Feiertage aus dem für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Feiertagssatz "2010 Holidays". Hierzu wird zunächst mithilfe von Get-CsRgsHolidaySet der entsprechende Feiertagssatz aus "ApplicationServer:atl-cs-001.litwareinc.com" abgerufen. Dieser Feiertagssatz wird dann in der Variablen "$x" gespeichert.

Nach dem Abrufen des Feiertagssatzes werden alle in der Eigenschaft "HolidayList" gespeicherten Werte mit der Clear-Methode entfernt. Nach dem Löschen des Inhalts dieser Eigenschaft verwendet der letzte Befehl im Beispiel das Cmdlet Set-CsRgsHolidaySet, um diese Änderungen in den Feiertagssatz "2010 Holidays" zu schreiben.