Freigeben über

  • Artikel

New-CsRgsHolidaySet

 

Letztes Änderungsdatum des Themas: 2012-03-23

Erstellt einen neuen Feiertagssatz für Reaktionsgruppen. 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

New-CsRgsHolidaySet -Parent <RgsIdentity> -HolidayList <Collection> -Name <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <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).

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. Nach ihrer Erfassung können Feiertage und die dazugehörigen Feiertagssätze Reaktionsgruppenworkflows zugewiesen werden.

Das Cmdlet New-CsRgsHolidaySet ermöglicht es Ihnen, neue Feiertagssätze für Ihre Organisation zu konfigurieren. Beachten Sie, dass ein neuer Feiertagssatz mindestens einen Feiertag enthalten muss. Diese einzelnen Feiertage müssen mit dem Cmdlet New-CsRgsHoliday erstellt werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

HolidayList

Erforderlich

Auflistung von Feiertagsobjekten

Ein Feiertag oder mehrere Feiertage, der bzw. die dem Feiertagssatz hinzugefügt werden sollen. Feiertage müssen mit dem Cmdlet New-CsRgsHoliday erstellt und dann in einem Objektverweis gespeichert werden. Diese Objektverweise werden dann an den Parameter "Holidays" übergeben, um die Feiertage dem Feiertagssatz hinzuzufügen. Mit diesem Befehl wird beispielsweise der Feiertag "New Year’s Day" erstellt und der resultierende Wert im Objektverweis "$x" gespeichert:

$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day"

Das Format der Angabe von Datum und Uhrzeit hängt von Ihren Sprach- und Regionseinstellungen ab. Die Beispiele in diesem Thema verwenden US-Englisch.

Name

Erforderlich

Zeichenfolge

Eindeutiger Name, der dem neuen Feiertagssatz zugewiesen werden muss. Die Kombination aus den Eigenschaften "Parent" und "Name" ermöglicht es Ihnen, Feiertagssätze eindeutig zu identifizieren, ohne auf die GUID des Satzes verweisen zu müssen.

Parent

Erforderlich

Rgs-ID

Dienst, von dem der neue Feiertagssatz gehostet wird. Beispiel: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com".

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

Eingabetypen

Keine. New-CsRgsHolidaySet akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsRgsHolidaySet werden neue Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet" erstellt.

Beispiel

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

$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day"
New-CsRgsHolidaySet -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2011 Holidays" -HolidayList($x)

Die Befehle in Beispiel 1 erstellen den neuen Feiertagssatz "2011 Holidays" und weisen diesem einen neuen Feiertag ("New Year’s Day") zu. Hierzu verwendet der erste Befehl New-CsRgsHoliday, um den Neujahrstag ("New Year’s Day") als Feiertag zu erstellen. New-CsRgsHoliday verwendet drei Parameter: "StartDate", der das Anfangsdatum des Feiertags angibt (1/1/2011 12:00 AM), "EndDate", der das Enddatum des Feiertags angibt (1/2/2011 12:00 AM), und "Name", mit dem der Name des Feiertags gespeichert wird. Das resultierende Feiertagsobjekt wird in der Variablen "$x" gespeichert.

Nach der Erstellung des neuen Feiertags im Arbeitsspeicher wird mithilfe des Cmdlets New-CsRgsHolidaySet ein neuer Feiertagssatz für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" erstellt. Dieser erhält den Namen "2011 Holidays" (-Name "2011 Holidays") und wird dem in der Variablen "$x" gespeicherten Feiertag zugewiesen: -HolidayList ($x). Wenn Sie einem Feiertagssatz mehrere Feiertage zuweisen möchten, erstellen Sie einfach die neuen Feiertage und weisen Sie jeden einer eindeutigen Variablen zu. Sie können alle diese Variablennamen dann als Parameterwert hinzufügen, der an "HolidayList" übergeben wird:

-HolidayList($x, $y, $z)