Get-CsRgsHolidaySet
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den Feiertagssätzen für Reaktionsgruppen zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind. 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
Get-CsRgsHolidaySet [-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).
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. Diese Feiertagssätze können dann Reaktionsgruppenworkflows zugewiesen werden.
Das Cmdlet Get-CsRgsHolidaySet bietet die Möglichkeit, Informationen zu den für die Verwendung in Ihrer Organisation konfigurierten Feiertagsätzen für Reaktionsgruppen zurückzugeben.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsRgsHolidaySet 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-CsRgsHolidaySet"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Rgs-ID |
Stellt entweder den Identitätswert des Diensts, der den Feiertagssatz hostet, oder den vollständigen Identitätswert des Feiertagssatzes dar. Wenn Sie die Dienstidentität angeben (z. B. "service:ApplicationServer:atl-cs-001.litwareinc.com"), werden alle von diesem Dienst gehosteten Feiertagssätze zurückgegeben. Wenn Sie den Identitätswert der Warteschleife angeben, wird nur der angegebene Feiertagssatz zurückgegeben. Beachten Sie, dass der Identitätswert eines Feiertagssatzes aus der Dienstidentität gefolgt von einer GUID besteht, z. B.: service:ApplicationServer:atl-cs-001.litwareinc.com/1987d3c2-4544-489d-bbe3-59f79f530a83. Alternativ können Sie zum Zurückgeben eines einzelnen Feiertagssatzes die Dienstidentität angeben und dann den Parameter "Name" gefolgt vom Namen des Feiertagssatzes hinzufügen. So können Sie einen bestimmten Feiertagssatz abrufen, ohne dass Ihnen die diesem zugewiesene GUID bekannt ist. Beim Aufrufen ohne Parameter gibt Get-CsRgsHolidaySet eine Auflistung aller für die Verwendung in Ihrer Organisation konfigurierten Feiertagssätze zurück. |
Name |
Optional |
Zeichenfolge |
Eindeutiger Name, der dem Feiertagssatz bei seiner Erstellung zugewiesen wurde. |
Eingabetypen
Keine. Get-CsRgsHolidaySet akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsRgsHolidaySet werden Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsRgsHolidaySet
Der vorstehende Befehl gibt Informationen zu allen in Ihrer Organisation konfigurierten Feiertagssätzen zurück.
-------------------------- Beispiel 2 --------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
Der Befehl in Beispiel 2 gibt Informationen zu allen für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" konfigurierten Feiertagssätzen zurück.
-------------------------- Beispiel 3 --------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
In Beispiel 3 wird ein einzelner Feiertagssatz aus dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com" zurückgegeben: der Satz mit dem Namen "2010 Holidays". Da Namen für jeden Dienst eindeutig sein müssen, kann dieser Befehl immer nur ein Element zurückgeben.
-------------------------- Beispiel 4 --------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"| Select-Object -ExpandProperty HolidayList
In Beispiel 4 werden ausführliche Informationen zu den Feiertagen im Feiertagssatz "2010 Holidays" angezeigt (die über den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" bereitgestellt werden). Hierzu verwendet der Befehl zunächst Get-CsRgsHolidaySet, um den angegebenen Feiertagssatz abzurufen. Dieser Satz wird dann an das Cmdlet Select-Object übergeben, das mithilfe des Parameters "ExpandProperty" ausführliche Informationen zu jedem Feiertag im Satz anzeigt.
-------------------------- Beispiel 5 --------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "Christmas Day"} | ForEach-Object {Get-CsRgsHolidaySet -Identity $_.Identity}
Der Befehl in Beispiel 5 gibt den Identitätswert jedes Feiertagssatzes für "ApplicationServer:atl-cs-001.litwareinc.com" zurück, der den Feiertag "Christmas Day" enthält. 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 Select-Object weitergeleitet, das zwei Schritte ausführt: Es wählt die Eigenschaft "Identity" aus und erweitert die Eigenschaft "HolidayList".
Diese beiden Informationen (der Identitätswert und der erweiterte Wert der Eigenschaft "HolidayList") werden an das Cmdlet Where-Object weitergeleitet. Das Cmdlet Where-Object filtert anschließend die Elemente heraus, bei denen der Name des Feiertags "Christmas Day" lautet. Zum Schluss wird die gefilterte Auflistung an das Cmdlet ForEach-Object weitergeleitet. Dieses Cmdlet verwendet jeden Identitätswert in der Anwendung und Get-CsRgsHolidaySet, um den entsprechenden Feiertagssatz abzurufen. Das Ergebnis ist eine Liste aller Feiertagssätze, die den Feiertag "Christmas Day" enthalten.