• Artikel

Remove-CsRgsHoursOfBusiness

 

Letztes Änderungsdatum des Themas: 2012-03-23

Entfernt einen bestehenden Geschäftszeitensatz für Reaktionsgruppen. Geschäftszeiten geben die Wochentage und die Uhrzeiten an, an denen Reaktionsgruppenagenten normalerweise zur Entgegennahme von Telefonanrufen zur Verfügung stehen.

Syntax

Remove-CsRgsHoursOfBusiness -Instance <BusinessHours> [-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).

Mit dem Cmdlet New-CsRgsHoursOfBusiness können Sie neue Geschäftszeitensätze erstellen. Diese Geschäftszeitensätze können zu einem späteren Zeitpunkt mit dem Cmdlet Remove-CsRgsHoursOfBusiness entfernt werden. Beachten Sie, dass durch Aufrufen von Remove-CsRgsHoursOfBusiness der gesamte Geschäftszeitensatz entfernt wird und nicht länger zur Verfügung steht. Wenn Sie lediglich Geschäftszeiten für einen bestimmten Tag entfernen möchten (z. B. weil der Helpdesk sonntags nicht mehr geöffnet ist), müssen Sie Set-CsRgsHoursOfBusiness verwenden, um ausschließlich die entsprechenden Eigenschaftswerte aus einer Auflistung zu entfernen.

Remove-CsRgsHoursOfBusiness zeigt standardmäßig eine Benachrichtigung an, wenn Sie versuchen, einen Geschäftszeitensatz zu löschen, der zurzeit von einem Workflow verwendet wird. Diese Benachrichtigung fordert Sie auf, das Löschen der Auflistung zu bestätigen. Weitere Schritte werden erst ausgeführt, wenn Sie auf die Benachrichtigung reagieren. Fügen Sie den Parameter "Force" hinzu, um die Benachrichtigung außer Kraft zu setzen und Geschäftszeitensätze ohne Benutzereingriff zu löschen, auch wenn diese zurzeit einem aktiven Workflow zugewiesen sind. Beispiel:

Get-CsRgsHoursOfBusiness –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsHoursOfBusiness –Force

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsRgsHoursOfBusiness 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-CsRgsHoursOfBusiness"}

Parameter

Parameter Erforderlich Typ Beschreibung

Instance

Erforderlich

Geschäftszeitenobjekt

Objektverweis auf die zu entfernenden Geschäftszeiten. Beim Weiterleiten von Workflowobjekten an Remove-CsRgsHoursOfBusiness können Sie den Parameter "Instance" weglassen.

Wenn Sie den Parameter "Instance" verwenden möchten, wählen Sie Befehle wie den Folgenden:

$x = Get-CsRgsHoursOfBusiness –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83

Remove-CsRgsHoursOfBusiness –Instance $x

Bei Angabe des Parameters "Instance" kann immer nur ein einzelner Geschäftszeitensatz entfernt werden. Dies bedeutet, dass Ihr Objektverweis ($x) nicht mehrere Geschäftszeitensätze enthalten kann.

Force

Optional

Switch-Parameter

Erzwingt das Löschen eines Geschäftszeitensatzes. Wenn dieser Parameter angegeben wurde, wird der Geschäftszeitensatz ohne Warnung entfernt, selbst wenn er derzeit einem aktiven Workflow zugewiesen ist. Wenn dieser Parameter nicht angegeben wurde, werden Sie aufgefordert, das Löschen von Geschäftszeitensä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

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

Eingabetypen

Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours-Objekt Remove-CsRgsHoursOfBusiness akzeptiert weitergeleitete Objektinstanzen des Geschäftszeitensatzes für Reaktionsgruppen.

Rückgabetypen

Mit "Remove-CsRgsHoursOfBusiness" werden vorhandene Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours" gelöscht.

Beispiel

-------------------------- Beispiel 1 --------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsHoursOfBusiness

Der Befehl in Beispiel 1 entfernt alle für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Geschäftszeitensätze. Hierzu ruft der Befehl zunächst Get-CsRgsHoursOfBusiness auf, um eine Auflistung aller für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Geschäftszeitensätze zurückzugeben. Diese Sätze werden dann an das Cmdlet Remove-CsRgsHoursOfBusiness weitergeleitet, das jeden ihm übergebenen Satz löscht.

-------------------------- Beispiel 2 --------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours" | Remove-CsRgsHoursOfBusiness

In Beispiel 2 wird ein einzelner Geschäftszeitensatz aus "ApplicationServer:atl-cs-001.litwareinc.com" entfernt: die Auflistung "Help Desk Business Hours".

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

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.SundayTimeRange1 -ne $Null -or $_.SundayTimeRange2 -ne $Null} | Remove-CsRgsHoursOfBusiness

Der vorstehende Befehl löscht alle Geschäftszeitensätze, in denen für sonntags Geschäftszeiten konfiguriert sind. Hierzu ruft der Befehl zunächst Get-CsRgsHoursOfBusiness auf, um eine Auflistung aller für "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Geschäftszeitensätze zurückzugeben. Diese Sätze werden dann an das Cmdlet Where-Object weitergeleitet, das nur die Elemente auswählt, bei denen die folgenden Kriterien zutreffen: Die Eigenschaft "SundayTimeRange1" weist keinen Nullwert auf, oder die Eigenschaft "SundayTimeRange2" weist keinen Nullwert auf. (Wenn eine Zeitraumeigenschaft keinen Nullwert aufweist, bedeutet dies, dass für diesen Zeitraum Geschäftszeiten konfiguriert wurden.) Beliebige Sätze, die mindestens eines dieser Kriterien erfüllen, werden dann an das Cmdlet Remove-CsRgsHoursOfBusiness weitergeleitet, das die entsprechenden Geschäftszeitensätze entfernt.

-------------------------- Beispiel 4 --------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.Custom -eq $True} | Remove-CsRgsHoursOfBusiness -Force

Der Befehl in Beispiel 4 löscht alle benutzerdefinierten Geschäftszeitensätze (d. h. Sätze, die nicht zwischen Workflows freigegeben werden können). Hierzu verwendet der Befehl zunächst Get-CsRgsHoursOfBusiness, um alle für "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Geschäftszeitensätze zurückzugeben. Diese Daten werden dann an das Cmdlet Where-Object weitergeleitet, das die Sätze herausfiltert, bei denen die Eigenschaft "Custom" den Wert "True" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese Sätze werden anschließend an das Cmdlet Remove-CsRgsHoursOfBusiness weitergeleitet und von diesem gelöscht.