Freigeben über

  • Artikel

Set-CsRgsHoursOfBusiness

 

Letztes Änderungsdatum des Themas: 2012-03-23

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

Syntax

Set-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).

Geschäftszeitensätze werden mit dem Cmdlet New-CsRgsHoursOfBusiness erstellt. Im Anschluss an ihre Erstellung können diese Sätze mit dem Cmdlet Set-CsRgsHoursOfBusiness geändert werden. Normalerweise werden dabei die Geschäftszeiten für einen oder mehrere Wochentage geändert. Wenn Ihr Helpdesk freitags von 8:00 Uhr bis 17:00 Uhr geöffnet ist, nun aber freitags bis 19:00 Uhr geöffnet ist, müssen Sie die Geschäftszeiten für Freitag ändern. Wenn der Helpdesk bisher samstags erreichbar war, jetzt aber samstags geschlossen ist, müssen Sie die Geschäftszeiten für Samstag gleichermaßen ändern. (Um anzugeben, dass ein Gruppe an einem bestimmten Tag nicht verfügbar ist, legen Sie für die Geschäftszeiten dieses Tags einfach einen Nullwert fest: -SundayTimeRange1 $Null.)

Beachten Sie beim Konfigurieren von Geschäftszeiten in einem Geschäftszeitensatz, dass jeder Wochentag sowohl die Eigenschaft "Hours1" als auch die Eigenschaft "Hours2" aufweist. Wenn der Helpdesk von 08:00 bis 17:00 Uhr erreichbar ist, müssen Sie lediglich der entsprechenden Eigenschaft "Hours1" Werte zuweisen. Angenommen, der Helpdesk ist von 08:00 bis 14:00 Uhr und dann wieder von 17:00 bis 23:00 Uhr erreichbar. In diesem Fall müssen Sie "Hours1" den Zeitraum von 08:00 bis 14:00 Uhr und "Hours2" den Zeitraum von 17:00 bis 23:00 Uhr zuweisen.

Beachten Sie, dass mit Set-CsRgsHoursOfBusiness ein Geschäftszeitensatz nicht direkt geändert wird. Sie müssen vielmehr mithilfe von Get-CsRgsHoursOfBusiness einen Objektverweis auf den zu ändernden Satz erstellen. (Beim Erstellen eines Objektverweises rufen Sie einfach eine Kopie des Geschäftszeitensatzes ab und speichern diese Kopie in einer Variablen.) Nach der Erstellung eines Objektverweises ändern Sie die Eigenschaften dieses nur im Arbeitsspeicher vorhandenen Objekts. Wenn Sie die Änderungen vorgenommen haben, schreiben Sie diese mit Set-CsRgsHoursOfBusiness in den eigentlichen Geschäftszeitensatz.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Instance

Erforderlich

BusinessHours-Objekt

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

$x = Get-CsRgsHoursOfBusiness -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

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 Set-CsRgsHoursOfBusiness akzeptiert weitergeleitete Objektinstanzen des Geschäftszeitensatzes für Reaktionsgruppen.

Rückgabetypen

Ändert vorhandene Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WriteableSettings.BusinessHours".

Beispiel

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

$weekend = New-CsRgsTimeRange -Name "Weekend Hours" -OpenTime "12:00" -CloseTime "17:00"

$x = Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
$x.SaturdayHours1 = $weekend
$x.SundayHours1 = $weekend
Set-CsRgsHoursOfBusiness -Instance $x

Das vorstehende Beispiel zeigt, dass Sie den Eigenschaften "SaturdayHours1" und "SundayHours1" des Geschäftszeitensatzes "Help Desk Business Hours" einen neuen Zeitraum zuweisen können. Hierzu erstellt der erste Befehl mithilfe von New-CsRgsTimeRange ein neues Zeitraumobjekt ("Weekend Hours") mit 12:00 Uhr als Beginn und 17:00 Uhr als Ende der Geschäftszeit. Dieses Objekt wird in der Variablen "$weekend" gespeichert.

Der nächste Befehl erstellt einen Objektverweis ("$x") auf den Geschäftszeitensatz "Help Desk Business Hours" für "ApplicationServer:atl-cs-001.litwareinc.com". Nach der Ausführung dieses Befehls werden mit Befehl 3 und 4 die Eigenschaften "SaturdayHours1" und "SundayHours1" auf den in "$weekend" gespeicherten Zeitraum festgelegt. Der letzte Befehl im Beispiel schreibt diese Änderungen dann mithilfe von Set-CsRgsHoursOfBusiness zurück in den tatsächlichen Geschäftszeitensatz.

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

$x = Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
$x.SaturdayHours1 = $Null
$x.SaturdayHours2 = $Null

Set-CsRgsHoursOfBusiness -Instance $x

Die Befehle in Beispiel 2 löschen die für die Eigenschaften "SaturdayHours1" und "SaturdayHours2" im Geschäftszeitensatz "Help Desk Business Hours" konfigurierten Werte. Hierzu erstellt der erste Befehl einen Objektverweis ("$x") auf den Geschäftszeitensatz "Help Desk Business Hours" für "ApplicationServer:atl-cs-001.litwareinc.com". Nach der Erstellung des Objektverweises legt der zweite Befehl die Eigenschaft "SaturdayHours1" auf einen Nullwert ($Null) fest. Damit werden alle Werte gelöscht, die "SaturdayHours1" möglicherweise zuvor zugewiesen wurden. Ein ähnlicher Befehl wird anschließend verwendet, um alle Werte zu löschen, die "SaturdayHours2" zuvor zugewiesen waren.

Der letzte Befehl im Beispiel schreibt diese Änderungen dann mithilfe von Set-CsRgsHoursOfBusiness in den tatsächlichen Geschäftszeitensatz zurück. Nach Abschluss der Befehlsausführung gibt es samstags keine Geschäftszeiten mehr, die "Help Desk Business Hours" zugewiesen sind.