Get-CsRgsConfiguration
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den Konfigurationseinstellungen für die Reaktionsgruppenanwendung zurück.
Syntax
Get-CsRgsConfiguration -Identity <RgsIdentity>
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 direkt 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?"). Anschließend wird er gemäß seiner Antworten an die entsprechenden Reaktionsgruppenwarteschleife weitergeleitet.
Das Cmdlet Get-CsRgsConfigurationbietet eine Möglichkeit, Informationen zur Konfiguration der Reaktionsgruppenanwendung zurückzugeben. Beachten Sie, dass dieses Cmdlet zu einem bestimmten Zeitpunkt standardmäßig nur Informationen aus einer Instanz der Reaktionsgruppenanwendung zurückgeben kann. Bei mehreren separaten Installationen der Reaktionsgruppenanwendung (einer für "ApplicationServer:atl-cs-001.litwareinc.com" und einer für "ApplicationServer:dublin-cs-001.litwareinc.com") müssen Sie Get-CsRgsConfiguration in separaten Aufrufen verwenden, um Informationen zu jeder dieser Reaktionsgruppeninstanzen zurückzugeben. Informationen dazu, wie diese Einschränkung umgangen werden kann, finden Sie im Abschnitt "Beispiele" in diesem Thema.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsRgsConfiguration 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-CsRgsConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Rgs-ID |
Name des Diensts, der die Konfigurationseinstellungen der Reaktionsgruppe hostet, z. B.: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". Wenn Sie diesen Parameter nicht angeben, werden Sie von Get-CsRgsConfiguration aufgefordert, einen Identitätswert anzugeben. |
Eingabetypen
Zeichenfolge. Get-CsRgsConfiguration akzeptiert einen Zeichenfolgenwert, der den Identitätswert der Konfigurationseinstellungen der Reaktionsgruppe darstellt.
Rückgabetypen
Mit Get-CsRgsConfigurationwerden Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
Mit Beispiel 1 werden alle Konfigurationseinstellungen der Reaktionsgruppe für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" zurückgegeben. Da es pro Dienst nur eine Auflistung der Einstellungen geben kann, gibt dieser Befehl immer nur ein einzelnes Element zurück.
-------------------------- Beispiel 2 --------------------------
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").DisableCallContext
Der vorstehende Befehl gibt den Wert der einzelnen Eigenschaft "DisableCallContext" für die im Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Konfigurationseinstellungen für Reaktionsgruppen zurück. Hierzu werden zunächst mit Get-CsRgsConfiguration alle Eigenschaftswerte für die Konfigurationseinstellungen für Reaktionsgruppen für "ApplicationServer:atl-cs-001.litwareinc.com" abgerufen. Beachten Sie, dass dieser Befehl von Klammern umgeben ist. So wird sichergestellt, dass Windows PowerShell zuerst alle Eigenschaftswerte zurückgibt.
Nachdem alle Eigenschaftswerte zurückgegeben wurden, wird der Wert der Eigenschaft "DisableCallContext" (und nur der Wert dieser) in der punktierten Standardschreibweise angezeigt. Diese Schreibweise besteht aus dem Objekt gefolgt von einem Punkt gefolgt vom Namen der anzuzeigenden Eigenschaft. Sie können beispielswiese folgenden Befehl verwenden, um (ausschließlich) den Wert der Eigenschaft "AgentRingbackGracePeriod" anzuzeigen:
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").AgentRingbackGracePeriod.
-------------------------- Beispiel 3 --------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Get-CsRgsConfiguration -Identity $_.Identity}
Der Befehl in Beispiel 3 veranschaulicht das Zurückgeben von Konfigurationseinstellungen für Reaktionsgruppen von allen Computern mit dem Anwendungsdienst, die eine Instanz der Reaktionsgruppenanwendung hosten. Hierzu verwendet der Befehl zunächst das Cmdlet Get-CsService und den Parameter "ApplicationServer", um Informationen zu allen Servern in der Organisation mit dem Anwendungsdienst zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Server 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 Server an das Cmdlet ForEach-Object weitergeleitet. ForEach-Object wählt dann jeden Server in der Auflistung aus und verwendet Get-CsRgsConfiguration zum Zurückgeben von Konfigurationseinstellungen für Reaktionsgruppen von jedem Server.