• Artikel

Get-CsRgsHoursOfBusiness

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft Informationen zu den in Ihrer Organisation konfigurierten Geschäftszeitenauflistungen für Reaktionsgruppen ab. Geschäftszeitenauflistungen geben die Wochentage und die Uhrzeiten an, an denen Reaktionsgruppenagenten normalerweise zur Entgegennahme von Telefonanrufen zur Verfügung stehen.

Syntax

Get-CsRgsHoursOfBusiness [-Identity <RgsIdentity>] [-Name <String>]

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

Das Cmdlet Get-CsRgsHoursOfBusiness bietet die Möglichkeit, Informationen zu allen Geschäftszeitenauflistungen zurückzugeben, die in Ihrer Organisation konfiguriert sind.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Rgs-ID

Stellt entweder die ID des Diensts dar, in dem die Geschäftszeitenauflistung gehostet wird, oder den vollständigen Identitätswert der Auflistung selbst. Wenn Sie die Dienstidentität angeben (z. B. "service:ApplicationServer:atl-cs-001.litwareinc.com"), werden alle von diesem Dienst gehosteten Geschäftszeitenauflistungen zurückgegeben. Wenn Sie den Identitätswert der Auflistung angeben, wird nur die angegebene Geschäftszeitenauflistung zurückgegeben. Beachten Sie, dass der Identitätswert einer Geschäftszeitenauflistung aus der Dienstidentität gefolgt von einer GUID besteht. Beispiel: service:ApplicationServer-1/1987d3c2-4544-489d-bbe3-59f79f530a83.

Eine weitere Möglichkeit zur Rückgabe einer Geschäftszeitenauflistung besteht darin, die Dienstidentität und den Parameter "Name" gefolgt vom Auflistungsnamen anzugeben. Hiermit können Sie eine bestimmte Geschäftszeitenauflistung abrufen, ohne die der Auflistung zugewiesene GUID kennen zu müssen.

Wenn Get-CsRgsHoursOfBusiness ohne Parameter aufgerufen wird, werden alle in Ihrer Organisation konfigurierten Geschäftszeitenauflistungen zurückgegeben.

Name

Optional

Zeichenfolge

Eindeutiger Name, der der Geschäftszeitenauflistung bei ihrer Erstellung zugewiesen wurde.

Eingabetypen

Keine. Get-CsRgsHoursOfBusiness akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit "Get-CsRgsHoursOfBusiness" werden Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours" zurückgegeben.

Beispiel

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

Get-CsRgsHoursOfBusiness

In Beispiel 1 werden Informationen zu allen Geschäftszeitenauflistungen zurückgegeben, die für die Verwendung in Ihrer Organisation konfiguriert wurden. Hierzu wird Get-CsRgsHoursOfBusiness ohne Parameter aufgerufen.

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

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

Der Befehl in Beispiel 2 gibt alle für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" konfigurierten Geschäftszeitenauflistungen zurück.

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

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

Mit dem vorstehenden Befehl wird eine einzelne Geschäftszeitenauflistung aus "ApplicationServer:atl-cs-001.litwareinc.com" entfernt: die Auflistung mit dem Namen "Help Desk Business Hours".

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

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

Mit dem vorstehenden Befehl werden alle Geschäftszeitenauflistungen zurückgegeben, deren Geschäftszeiten für sonntags konfiguriert wurden. Hierzu ruft der Befehl zunächst Get-CsRgsHoursOfBusiness auf, um alle für "atl-cs-001.litwareinc.com" gefundenen Geschäftszeitenauflistungen zurückzugeben. Diese Daten 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, und/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.

-------------------------- Beispiel 5 --------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.MondayTimeRange1.OpenTime -le "08:00:00"}

Der Befehl in Beispiel 5 gibt alle Geschäftszeitenauflistungen von "atl-cs-001.litwareinc.com" zurück, bei denen die Anfangsuhrzeit für die Eigenschaft "MondayTimeRange1" kleiner gleich 08:00 Uhr ist. Hierzu ruft der Befehl zunächst Get-CsRgsHoursOfBusiness auf, um alle für "atl-cs-001.litwareinc.com" gefundenen Geschäftszeitenauflistungen zurückzugeben. Diese Daten werden dann an das Cmdlet Where-Object weitergeleitet, das die Auflistungen herausfiltert, bei denen die Eigenschaft "MondayTimeRange1.OpenTime" kleiner gleich 08:00 Uhr ist (der Vergleichsoperator "-le" steht für "less than").

-------------------------- Beispiel 6 --------------------------

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

Der Befehl in Beispiel 6 gibt alle öffentlichen Geschäftszeitenauflistungen zurück (also Auflistungen, die zwischen Workflows freigegeben werden können). Hierzu ruft der Befehl zunächst Get-CsRgsHoursOfBusiness auf, um eine Auflistung aller für "atl-cs-001.litwareinc.com" gefundenen Geschäftszeitenauflistungen zurückzugeben. Diese Daten werden dann an das Cmdlet Where-Object weitergeleitet, das die Auflistungen herausfiltert, bei denen die Eigenschaft "Custom" den Wert "False" ($False) aufweist (der Vergleichsoperator "-eq" steht für "equal to").