New-CsRgsTimeRange
Letztes Änderungsdatum des Themas: 2012-03-23
Erstellt einen neuen Zeitraum für die Reaktionsgruppe. Die Reaktionsgruppenanwendung verwendet Zeiträume, um den Beginn und das Ende der Geschäftszeiten für einen Geschäftstag anzugeben. Wenn die Helpdeskagenten sonntags nur von 12:00 bis 17:00 Uhr erreichbar ist, müssen Sie einen Zeitraum für Sonntag erstellen, der als Beginn der Geschäftszeit 12:00 Uhr und als Ende der Geschäftszeit 17:00 Uhr hat.
Syntax
New-CsRgsTimeRange -CloseTime <Nullable> -OpenTime <Nullable> [-Name <String>]
Detaillierte Beschreibung
Die Reaktionsgruppenanwendung verwendet Auflistungen von Geschäftszeiten zum Nachverfolgen der Wochentage und der Uhrzeiten, an denen dieser Agent normalerweise zur Entgegennahme von Anrufen verfügbar ist. Angenommen, der Helpdesk ist montags von 7:00 bis 19:00 Uhr erreichbar. In diesem Fall müssen Sie zwei Aufgaben ausführen. Sie müssen mithilfe des Cmdlets New-CsRgsHoursOfBusiness eine Auflistung von Geschäftszeiten für den Helpdesk erstellen und die Eigenschaft "MondayTimeRange1" so ändern, dass sie 7:00 Uhr als Beginn und 19:00 Uhr als Ende der Geschäftszeit angibt.
Zum Ändern einer bestehenden Auflistung von Geschäftszeiten müssen Sie das Cmdlet Set-CsRgsHoursOfBusiness verwenden. Mit diesem Cmdlet können Sie eine Zeitraumeigenschaft allerdings nicht direkt ändern (Set-CsRgsHoursOfBusiness bietet beispielsweise keinen Parameter, der der Eigenschaft "MondayTimeRange1" entspricht). Stattdessen müssen Sie beim Ändern einer Auflistung von Geschäftszeiten diese Auflistung mithilfe von Get-CsRgsHoursOfBusiness abrufen, die Auflistung im Arbeitsspeicher ändern und diese Änderungen dann mit Set-CsRgsHoursOfBusiness in die tatsächliche Auflistung von Geschäftszeiten schreiben.
In den meisten Fällen wird beim Ändern einer Auflistung von Geschäftszeiten der Beginn und/oder das Ende der Geschäftszeiten an einem bestimmten Tag (oder an bestimmten Tagen) geändert. Sie müssen den Beginn und das Ende der Geschäftszeiten mit dem Cmdlet New-CsRgsTimeRange ändern. Beim Aufrufen dieses Cmdlets muss der resultierende Wert in einer Objektverweisvariablen gespeichert werden. Mit dieser Variablen werden dann der Beginn und das Ende der Geschäftszeiten in der Auflistung von Geschäftszeiten festgestellt.
Ferner müssen Sie mit New-CsRgsTimeRange beim Erstellen einer neuen Auflistung von Geschäftszeiten jedes Mal den Beginn und das Ende der Geschäftszeiten angeben.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsRgsTimeRange 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-CsRgsTimeRange"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
CloseTime |
Erforderlich |
TimeSpan |
Tageszeit des Endes der Geschäftszeiten. "CloseTime" muss im 24-Stunden-Format angegeben werden. Verwenden Sie beispielsweise folgendes Format, um für das Ende der Geschäftszeiten 21:00 Uhr festzulegen: -CloseTime "21:00". |
OpenTime |
Erforderlich |
TimeSpan |
Tageszeit des Beginns der Geschäftszeiten. "OpenTime" muss im 24-Stunden-Format angegeben werden. Verwenden Sie beispielsweise folgendes Format, um für den Beginn der Geschäftszeiten 13:30 Uhr festzulegen: -OpenTime "13:30". |
Name |
Optional |
Zeichenfolge |
Eindeutige ID für den zu erstellenden Zeitraum. Ihr Name kann maximal 128 Zeichen lang sein. |
Eingabetypen
Keine. New-CsRgsTimeRange akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit New-CsRgsTimeRange werden neue Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.TimeRange" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
$y = Get-CsRgsHoursOfBusiness -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours"
$y.SundayHours1 = $sundayHours
Set-CsRgsHoursOfBusiness -Instance $y
Im vorstehenden Beispiel wird veranschaulicht, wie Sie die Eigenschaften eines bestehenden Geschäftszeitensatzes mit dem Cmdlet New-CsRgsTimeRange ändern können. In diesem Beispiel wird zunächst New-CsRgsTimeRange aufgerufen, um den neuen Zeitraum "Sunday hours" zu erstellen. Dieser Zeitraum legt 08:30 als Beginn und 13:30 als Ende der Geschäftszeiten fest. Der von diesem Befehl erstellte, lediglich im Arbeitsspeicher vorhandene Zeitraum wird in der Variablen "$sundayHours" gespeichert.
Nach der Konfiguration des Zeitraums gibt der zweite Befehl im Beispiel mit dem Cmdlet Get-CsRgsHoursOfBusiness die Auflistung von Geschäftszeiten mit dem Namen "Help Desk Hours" zurück (die für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurde). Die zurückgegebene Auflistung wird dann in der Variablen "$y" gespeichert.
Nachdem die Auflistung abgerufen wurde, wird mit Befehl 3 der Wert der Eigenschaft "SundayHours1" auf "$sundayHours" festgelegt. Hierbei handelt es sich um den Objektverweis, der den neu erstellten Zeitraum enthält. Nach der Ausführung dieses Befehls werden diese Änderungen mit Set-CsRgsHoursOfBusiness in die Auflistung von Geschäftszeiten "Help Desk Hours" geschrieben. Der neu erstellte Zeitraum ist nur im Arbeitsspeicher vorhanden. Wenn Sie Set-CsRgsHoursOfBusiness nicht aufrufen, geht er verloren, sobald Sie Windows PowerShell schließen oder die Variable "$sundayHours" löschen. In diesem Fall wird die Auflistung von Geschäftszeiten "Help Desk Hours" nicht aktualisiert.
-------------------------- Beispiel 2 --------------------------
$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
New-CsRgsHoursOfBusiness -Parent Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours" -SundayHours1 $sundayHours
In Beispiel 2 wird veranschaulicht, wie Sie einen neuen Zeitraum für Reaktionsgruppen erstellen und diesen in einem neuen Satz mit Geschäftszeiten verwenden. Der erste Befehl im Beispiel erstellt mithilfe des Cmdlets New-CsRgsTimeRange den neuen Zeitraum "Sunday Hours". "OpenTime" für den Zeitraum ist auf 8:30 AM ("08:30") und "CloseTime" auf 1:30 PM ("13:30") festgelegt. Das resultierende Zeitraumobjekt wird dann in der Variablen "$sundayHours" gespeichert.
Im zweiten Befehl wird das Cmdlet New-CsRgsBusinessHours zum Erstellen der neuen Auflistung von Geschäftszeiten "Help Desk Hours" verwendet. In diesem Befehl gibt die Variable "$sundayHours" den Zeitraum für die Eigenschaft "SundayHours1" an.