Freigeben über

  • Artikel

Get-CsCpsConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zum Dienst für das Parken von Anrufen zurück. Die Funktion zum Parken von Anrufen ist ein Dienst, über den Benutzer eingehende Anrufe "parken" können. Beim Parken eines Anrufs wird der Anruf an eine Nummer in einem angegebenen Bereich (oder Orbit) übergeben und anschließend sofort in der Warteschleife platziert. Sämtliche Benutzer (nicht nur der Benutzer, der den Anruf ursprünglich entgegengenommen hat) können das Gespräch von einem beliebigen Telefon im System aus fortführen, indem sie die richtige Nummer eingeben.

Syntax

Get-CsCpsConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsCpsConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Dieses Cmdlet wird verwendet, um mindestens eine Konfiguration des Diensts für das Parken von Anrufen abzurufen. Eine Konfiguration des Diensts für das Parken von Anrufen gibt an, wie mit einem geparkten Anruf verfahren wird. Wenn ein geparkter Anruf beispielsweise nach einem bestimmten Zeitraum nicht beantwortet wird, kann er automatisch an einen anderen Benutzer, z. B. an einen Administrator, oder an eine Reaktionsgruppe weitergeleitet werden. Um zu verhindern, dass Anrufe vergessen werden, können die Einstellungen auch so konfiguriert werden, dass das Telefon nach einem bestimmten Zeitraum erneut läutet. Darüber hinaus kann der Dienst für das Parken von Anrufen so konfiguriert werden, dass für den Anrufer eines geparkten Anrufs Wartemusik wiedergegeben wird.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsCpsConfiguration lokal auszuführen: RTCUniversalUserAdmins, 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 "Get-CsCpsConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID für die Konfiguration des Diensts zum Parken von Anrufen, die abgerufen werden soll. Diese ID lautet entweder "Global" oder "site:<Standortname>". Dabei steht <Standortname> für den Namen des Standorts, für den die Konfiguration gilt.

Filter

Optional

Zeichenfolge

Ermöglicht das Ausführen einer Platzhalterzeichensuche, um nur diejenigen Konfigurationen abzurufen, deren Identitätswerte mit der Platzhalterzeichenfolge übereinstimmen.

LocalStore

Optional

Switch-Parameter

Ruft die Informationen zum Dienst für das Parken von Anrufen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Gibt mindestens ein Objekt vom Typ Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings zurück.

Beispiel

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

Get-CsCpsConfiguration

In Beispiel 1 wird eine Auflistung aller Konfigurationen für den Dienst zum Parken von Anrufen abgerufen, die für Ihre Organisation definiert wurden.

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

Get-CsCpsConfiguration -Identity site:Redmond1

Mit dem vorstehenden Befehl werden nur die Konfigurationen für den Dienst zum Parken von Anrufen mit dem Identitätswert "site:Redmond1" abgerufen.

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

Get-CsCpsConfiguration -Filter site:*

In Beispiel 3 werden mithilfe des Parameters "Filter" alle Konfigurationen für den Dienst zum Parken von Anrufen zurückgegeben, die auf Standortebene konfiguriert wurden. Die Platzhalterzeichenfolge "site:*" weist das Cmdlet Get-CsCpsConfiguration an, nur die Einstellungen zurückzugeben, deren Identitätswert mit der Zeichenfolge "site:" beginnt.

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

Get-CsCpsConfiguration -Filter *:re*

Wie in Beispiel 3 wird der Parameter "Filter" verwendet, um einen Teilsatz aller definierten Konfigurationen für den Dienst zum Parken von Anrufen abzurufen. In diesem Fall wird nach der Zeichenfolge ":re*" gefiltert, wodurch alle Konfigurationen für den Dienst zum Parken von Anrufen zurückgegeben werden, deren Namen mit den Buchstaben "re" beginnen, z. B. "Redmond1", "Redmond2" und "RemoteComputer".

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

Get-CsCpsConfiguration | Where-Object {$_.EnableMusicOnHold -eq $False}

Der oben gezeigte Befehl gibt alle Einstellungen des Diensts zum Parken von Anrufen zurück, bei denen für einen geparkten Anruf keine Wartemusik wiedergegeben wird. Zu diesem Zweck verwendet der Befehl zunächst Get-CsCpsConfiguration zum Abrufen aller Einstellungen des Diensts für das Parken von Anrufen in Ihrer Organisation. Diese Informationen werden anschließend an das Cmdlet Where-Object weitergeleitet, das wiederum einen Filter anwendet, um die zurückgegebenen Daten auf diejenigen Elemente zu beschränken, deren Eigenschaft "EnableMusicOnHold" auf "False" festgelegt ist (der Vergleichsoperator "-eq" steht für "equal to").