Freigeben über

  • Artikel

Get-CsCdrConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den Einstellungen für die Aufzeichnung von Kommunikationsdatensätzen (KDS) zurück. Die KDS-Funktion ermöglicht das Nachverfolgen von Peer-zu-Peer-, VoIP- und Konferenzanrufen.

Syntax

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

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

Detaillierte Beschreibung

Die KDS-Funktion bietet eine Möglichkeit, die Nutzung von Microsoft Lync Server 2010-Funktionen wie VoIP-Anrufe, Sofortnachrichten, Dateiübertragungen, Audio-/Videokonferenzen und Anwendungsfreigabesitzungen nachzuverfolgen. KDS (das nur verfügbar ist, wenn Sie den Überwachungsdienst bereitgestellt haben) zeichnet Verwendungsinformationen auf: Hierbei werden z. B. Anrufer, Angerufener, Anrufdauer und Informationen dazu aufgezeichnet, ob Dateien übertragen wurden. (Die KDS-Funktion zeichnet den eigentlichen Anruf jedoch nicht auf.)

Die KDS-Funktion verfolgt auch Informationen zu Anruffehlern nach, so z. B. detaillierte Diagnosedaten für Peer-zu-Peer-Sitzungen und Konferenzanrufe.

Als Administrator können Sie bestimmen, ob KDS in Ihrer Organisation zum Einsatz kommen soll. Sofern der Überwachungsdienst bereitgestellt wurde, kann KDS aktiviert oder deaktiviert werden. Sie können KDS außerdem entweder in der gesamten Organisation oder standortbezogen aktivieren oder deaktivieren. Sie können KDS z. B. am Standort "Redmond" aktivieren, aber am Standort "Paris" deaktivieren.

Das Cmdlet Get-CsCdrConfiguration bietet eine Möglichkeit der Rückgabe detaillierter Informationen dazu, wie die Aufzeichnung von Kommunikationsdatensätzen (KDS) in Ihrer Organisation verwendet wird.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Gibt die eindeutige ID für die Auflistung der zurückzugebenden KDS-Konfigurationseinstellungen an. Verwenden Sie folgende Syntax, um auf die globalen Einstellungen zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf eine Auflistung zu verweisen, die auf Standortebene konfiguriert ist: -Identity site:Redmond. Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können. Wenn Platzhalter nötig sind, verwenden Sie stattdessen den Parameter "Filter".

Wenn dieser Parameter nicht angegeben ist, gibt Get-CsCdrConfiguration eine Auflistung aller in der Organisation verwendeten KDS-Konfigurationseinstellungen zurück.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen, um eine Auflistung von KDS-Konfigurationseinstellungen zurückzugeben. Verwenden Sie beispielsweise folgende Syntax, um eine Auflistung aller auf der Standortebene konfigurierten Einstellungen zurückzugeben. -Filter site:*. Verwenden Sie folgende Syntax, um eine Auflistung aller Einstellungen zurückzugeben, deren Identitätswert den Zeichenfolgenwert "Western" aufweist: -Filter *Western*.

LocalStore

Optional

Switch-Parameter

Ruft die KDS-Konfigurationsdaten aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsCdrConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsCdrConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings" zurückgegeben.

Beispiel

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

Get-CsCdrConfiguration

Bei diesem Beispiel gibt Get-CsCdrConfiguration eine Auflistung aller Einstellungen für die Aufzeichnung von Kommunikationsdatensätzen zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind.

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

Get-CsCdrConfiguration -Identity site:Redmond

In Beispiel 2 wird der Parameter "Identity" verwendet, um eine einzelne Auflistung von KDS-Einstellungen zurückzugeben: die Einstellungen mit dem Identitätswert "site:Redmond".

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

Get-CsCdrConfiguration -Filter site:*

In Beispiel 3 werden mithilfe des Parameters "Filter" alle Einstellungen für die Aufzeichnung von Kommunikationsdatensätzen zurückgegeben, die auf Standortebene konfiguriert wurden. Der Filterwert "site:*" gibt alle Einstellungen für die Aufzeichnung von Kommunikationsdatensätzen zurück, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Laut Definition sind dies Einstellungen, die auf Standortebene konfiguriert wurden.

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

Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30}

Das vorherige Beispiel gibt eine Auflistung aller Einstellungen für die Aufzeichnung von Kommunikationsdatensätzen zurück, bei denen der Wert der Eigenschaft "KeepCallDetailForDays" kleiner als 30 Tage ist. Zu diesem Zweck verwendet der Befehl zunächst Get-CsCdrConfiguration, um eine Auflistung aller in der Organisation konfigurierten Einstellungen für die Aufzeichnung von Kommunikationsdatensätzen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "KeepCallDetailForDays" einen geringeren Wert als 30 aufweist.