Remove-CsRgsHolidaySet
Letztes Änderungsdatum des Themas: 2012-03-23
Entfernt einen bestehenden Feiertagssatz 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
Remove-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. Nach ihrer Erfassung können Feiertage und Feiertagssätze Reaktionsgruppenworkflows zugewiesen werden.
Mit dem Cmdlet Remove-CsRgsHolidaySet können Administratoren Feiertagssätze für Reaktionsgruppen entfernen. Wenn Sie versuchen, einen Feiertagssatz zu entfernen, der derzeit einem aktiven Workflow zugewiesen ist, wird das Cmdlet standardmäßig angehalten, und Sie werden gefragt, ob Sie den Workflow wirklich löschen möchten. Sie müssen auf diese Benachrichtigung reagieren, bevor der Befehl fortgesetzt und der Feiertagssatz entfernt werden kann. Fügen Sie den Parameter "Force" hinzu, um diese Benachrichtigung außer Kraft zu setzen und einen Feiertagssatz auch dann zu entfernen, wenn er zurzeit von einem aktiven Workflow verwendet wird:
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet –Force
Beachten Sie, dass durch Aufrufen von Remove-CsRgsHolidaySet der gesamte Feiertagssatz entfernt wird und nicht länger zur Verfügung steht. Wenn Sie lediglich einen einzelnen Feiertag aus einem Feiertagssatz entfernen möchten (z. B. weil der Helpdesk am Nationalfeiertag nicht mehr geöffnet ist), müssen Sie Set-CsRgsHolidaySet verwenden, um ausschließlich den angegebenen Feiertag zu entfernen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-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 "Remove-CsRgsHolidaySet"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Instance |
Erforderlich |
Feiertagssatzobjekt |
Objektverweis auf den zu entfernenden Feiertagssatz. Beim Weiterleiten von Workflowobjekten an Remove-CsRgsHolidaySet können Sie den Parameter "Instance" weglassen. Wenn Sie den Parameter "Instance" verwenden möchten, wählen Sie Befehle wie den Folgenden: $x = Get-CsRgsHolidaySet –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsHolidaySet –Instance $x Bei Angabe des Parameters "Instance" kann immer nur ein einzelner Feiertagssatz entfernt werden. Dies bedeutet, dass Ihr Objektverweis ($x) nicht mehrere Feiertagssätze enthalten kann. |
Force |
Optional |
Switch-Parameter |
Erzwingt das Entfernen des Feiertagssatzes. Wenn dieser Parameter angegeben wurde, wird der Feiertagssatz ohne Warnung entfernt, selbst wenn er von einem aktiven Workflow verwendet wird. Wenn dieser Parameter nicht angegeben wurde, werden Sie aufgefordert, das Löschen von Feiertagssätzen zu bestätigen, die zurzeit einem aktiven Workflow zugewiesen sind. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Dieser Parameter wird nur zu Testzwecken verwendet. |
Eingabetypen
Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet-Objekt Remove-CsRgsHolidaySet akzeptiert weitergeleitete Objektinstanzen des Feiertagssatzes für Reaktionsgruppen.
Rückgabetypen
Mit Remove-CsRgsHolidaySet werden vorhandene Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet" gelöscht.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet
Der Befehl in Beispiel 1 entfernt den Feiertagssatz "2010 Holidays" für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com". Hierzu ruft der Befehl zunächst Get-CsRgsHolidaySet zusammen mit zwei Parametern auf: "Identity" (der den Speicherort des Feiertagssatzes angibt) und "Name" (der den Namen des Feiertagssatzes angibt). Das zurückgegebene Objekt wird dann an Remove-CsRgsHolidaySet weitergeleitet, das den Feiertagssatz "2010 Holidays" löscht.
-------------------------- Beispiel 2 --------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "New Year's Day"} | Remove-CsRgsHolidaySet
Der vorstehende Befehl löscht alle Feiertagssätze für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com", die den Feiertag "New Year’s Day" enthalten. Hierzu verwendet der Befehl zunächst Get-CsRgsHolidaySet, um eine Auflistung aller für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Feiertagssätze zurückzugeben. Diese Auflistung wird dann an das Cmdlet Select-Object weitergeleitet, das zwei Schritte ausführt: Es wählt die Eigenschaft "Identity" für jeden Feiertagssatz aus und "erweitert" den Wert der Eigenschaft "HolidayList". (Beim Erweitern eines Werts geben Sie die Eigenschaften des zugrunde liegenden Objekts zurück. Bei einem Feiertag sind dies Eigenschaften wie beispielsweise "Name", "StartDate" und "EndDate"). Die ausgewählten Informationen (der Identitätswert des Feiertagssatzes und die Eigenschaftswerte des Feiertags) werden dann an das Cmdlet Where-Object weitergeleitet, das die Sätze herausfiltert, die einen Feiertag enthalten, dessen Eigenschaft "Name" dem Wert "New Year’s Day" entspricht (der Vergleichsoperator "-eq" steht für "equal to"). Die gefilterte Auflistung von Feiertagssätzen wird dann an das Cmdlet Remove-CsRgsHolidaySet weitergeleitet, das jeden Feiertagssatz löscht, der den Feiertag "New Year’s Day" umfasst.
-------------------------- Beispiel 3 --------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.HolidayList.Count -lt 5} | Remove-CsRgsHolidaySet
Der Befehl in Beispiel 3 löscht alle Feiertagssätze aus dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com", denen weniger als fünf Feiertage zugewiesen sind. Hierzu ruft der Befehl zunächst Get-CsRgsHolidaySet auf, um eine Auflistung aller für "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Feiertagssätze zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Feiertagssätze auswählt, bei denen die Anzahl der zugewiesenen Feiertage ($_.HolidayList.Count) kleiner als 5 ist (der Vergleichsoperator "-lt" steht für "less than"). Diese Feiertagssätze werden anschließend an das Cmdlet Remove-CsRgsHolidaySet weitergeleitet und von diesem gelöscht.