Set-CsRgsConfiguration
Letztes Änderungsdatum des Themas: 2012-03-23
Ändert Konfigurationseinstellungen für die Reaktionsgruppenanwendung.
Syntax
Set-CsRgsConfiguration -Identity <RgsIdentity> [-AgentRingbackGracePeriod <Int16>] [-Confirm [<SwitchParameter>]] [-DefaultMusicOnHoldFile <AudioFile>] [-DisableCallContext <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsRgsConfiguration -Instance <ServiceSettings> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Die Reaktionsgruppenanwendung bietet eine Möglichkeit, Telefonanrufe automatisch an Entitäten wie einen Helpdesk oder den Kundensupport weiterzuleiten. Wenn jemand eine festgelegte Telefonnummer anruft, kann der Anruf automatisch an den entsprechenden Satz von Reaktionsgruppenagenten weitergeleitet werden. Stattdessen kann der Anruf auch an eine Warteschleife des interaktiven Sprachantwortsystems (Interactive Voice Response, IVR) weitergeleitet werden. In dieser Warteschleife werden dem Anrufer eine Reihe von Fragen gestellt (z. B. "Haben Sie Fragen zu einer aktuellen Bestellung?"). Dieser erhält dann gemäß seiner Antworten die gewünschten Informationen oder wird an einen Reaktionsgruppenagenten weitergeleitet.
Das Cmdlet Set-CsRgsConfiguration bietet die Möglichkeit, die Eigenschaften einer Instanz der Reaktionsgruppenanwendung zu ändern.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsRgsConfiguration 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-CsRgsConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Rgs-ID |
Name des Diensts, der die Konfigurationseinstellungen der Reaktionsgruppe hostet, z. B.: Beispiel: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Instance |
Optional |
ServiceSettings-Objekt |
Objektverweis auf die zu ändernden Konfigurationseinstellungen der Reaktionsgruppe. Ein Objektverweis wird in der Regel über das Cmdlet Get-CsRgsConfiguration und durch Zuweisen des zurückgegebenen Werts zu einer Variablen abgerufen. Beispielsweise gibt dieser Befehl einen Objektverweis auf die Konfigurationseinstellungen zurück, die sich im Dienst "ApplicationServer:atl-cs-001.litwareinc.com" befinden, und speichert diesen Objektverweis in einer Variablen namens "$x": $x = Get-CsRgsConfiguration -Identity service:ApplicationServer:atl-cs-001.litwareinc.com |
AgentRingbackGracePeriod |
Optional |
Ganze Zahl |
Wenn ein Agent einen Anruf abweist, stellt "AgentRingbackGracePeriod" den Zeitraum (in Sekunden) dar, bevor der Anruf an denselben Agenten zurückgegeben wird. Die Kulanzfrist kann auf einen beliebigen ganzzahligen Wert zwischen 30 und 600 Sekunden (10 Minuten) festgelegt werden. Der Standardwert beträgt 60 Sekunden. |
DefaultMusicOnHoldFile |
Optional |
AudioFile-Objekt |
Gibt die Musik an, die standardmäßig wiedergegeben wird, wenn ein Anruf gehalten wird. Die Standardmusik wird nur dann wiedergegeben, wenn ein Reaktionsgruppenworkflow keine eigene Wartemusik definiert hat. Die Eigenschaft "DefaultMusicOnHoldFile" muss mithilfe eines über das Cmdlet Import-CsRgsAudioFile erstellten Objektverweises konfiguriert werden. Wenn "DefaultMusicOnHold" einem Nullwert (dem Standardwert) entspricht und für einen Workflow keine benutzerdefinierte Wartemusik definiert ist, wird die standardmäßige Wartemusik, die bei der Installation von Lync Server automatisch konfiguriert wird, immer dann wiedergegeben, wenn ein Anrufer in einer Warteschleife platziert wird. |
DisableCallContext |
Optional |
Switch-Parameter |
Bei "False" (Standardwert) kann jeder Agent für jeden eingehenden Anruf den Anrufkontext einsehen. Dazu gehören Informationen wie Anrufwartezeit sowie Workflowfragen und -antworten. (Diese Informationen werden in Microsoft Lync 2010 angezeigt.) Bei "True" werden Informationen zum Anrufkontext bei Eingang eines Anrufs nicht an Agenten übermittelt. Der Anrufkontexten wird nur bei Warteschleifen des interaktiven Sprachantwortsystems verwendet. |
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.ServiceSettings-Objekt Set-CsRgsConfiguration akzeptiert weitergeleitete Einstellungsobjektinstanzen der Reaktionsgruppenanwendung.
Rückgabetypen
Mit Set-CsRgsConfiguration werden keine Objekte oder Werte zurückgegeben. Stattdessen werden mit dem Cmdlet bestehende Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings" konfiguriert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -AgentRingbackGracePeriod 30
Der Befehl in Beispiel 1 ändert die Eigenschaft "AgentRingbackGracePeriod" für die im Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Konfigurationseinstellungen für die Reaktionsgruppenanwendung. In diesem Beispiel ist "AgentRingbackGracePeriod" auf 30 Sekunden festgelegt.
-------------------------- Beispiel 2 --------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Set-CsRgsConfiguration -Identity $_.Identity -AgentRingbackGracePeriod 30}
In Beispiel 2 wird der Parameter "AgentRingbackGracePeriod" in allen Konfigurationseinstellungen für Reaktionsgruppen in der Organisation geändert. Hierzu verwendet der Befehl zunächst das Cmdlet Get-CsService und den Parameter "ApplicationServer", um Informationen zu allen Computern in der Organisation mit dem Anwendungsdienst zurückzugeben. Die zurückgegebene Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Computer herausfiltert, deren Eigenschaft "Applications" die Anwendung "urn:application:RGS" enthält. Dieser Wert bedeutet, dass die Reaktionsgruppenanwendung auf dem Server ausgeführt wird.
Anschließend werden diese Computer an das Cmdlet ForEach-Object weitergeleitet. ForEach-Object legt danach für jeden Computer in der Auflistung mit dem Cmdlet Set-CsRgsConfiguration den Wert des Parameters "AgentRingbackGracePeriod" in den Konfigurationseinstellungen für die Reaktionsgruppe des Computers auf 30 Sekunden fest.
-------------------------- Beispiel 3 --------------------------
$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content (Get-Content C:\Media\WhileYouWait.wav -Encoding byte -ReadCount 0)
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -DefaultMusicOnHoldFile $x
Die Befehle in Beispiel 3 importieren eine Audiodatei ("C:\Media\WhileYouWait.wav") und weisen diese dann der Eigenschaft "DefaultMusicOnHoldFile" zu. Hierzu verwendet der Befehl zunächst Import-CsRgsAudioFile, um die Audiodatei in die Reaktionsgruppenanwendung für "ApplicationServer:atl-cs-001.litwareinc.com" zu importieren. Neben dem Parameter "Identity" (der die Dienstidentifizierung angibt) wird mit dem Parameter "FileName" der Name der zu importierenden Datei angegeben.
Außerdem wird der Parameter "Content" zum Importieren der Audiodatei verwendet. Der Dateiimport erfolgt durch Aufrufen des Cmdlets Get-Content gefolgt vom Pfad zu der zu importierenden Datei. Bei Get-Content müssen Sie außerdem den Verschlüsselungstyp auf "byte" und den Wert für "ReadCount" auf 0 festlegen. (Die Festlegung von "ReadCount" den Wert 0 stellt sicher, dass die gesamte Datei in einem Arbeitsschritt gelesen wird.) Die importierte Datei wird dann in der Variablen "$x" gespeichert.
Nach dem Import der Datei wird Set-CsRgsConfiguration aufgerufen, um die Eigenschaft "DefaultMusicOnHold" auf die in "$x" gespeicherte Audiodatei festzulegen.