Freigeben über

  • Artikel

Set-CsCdrConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine vorhandene Auflistung von Einstellungen für die Aufzeichnung von Kommunikationsdatensätzen (KDS). Die KDS-Funktion ermöglicht das Nachverfolgen von Peer-zu-Peer-, VoIP- und Konferenzanrufen. Diese Nutzungsdaten umfassen Informationen wie z. B. Anrufer, Angerufener, Anrufzeitpunkt und Anrufdauer.

Syntax

Set-CsCdrConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Set-CsCdrConfiguration [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Die KDS-Funktion bietet eine Möglichkeit, die Nutzung von Microsoft Lync Server 2010-Funktionen wie VoIP-Anrufe (Voice over Internet Protocol), Sofortnachrichten (Instant Messaging), Dateiübertragungen, Audio-/Videokonferenzen (A/V) 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 einfach aktiviert oder deaktiviert werden. Außerdem können Sie diese Entscheidung global (in diesem Fall ist KDS in der gesamten Organisation entweder aktiviert oder deaktiviert) oder auf Standortbasis treffen. Beispielsweise können Sie KDS am Standort Redmond, jedoch nicht am Standort Paris verwenden.

Administratoren können außerdem die KDS-Datenbank verwalten. Sie können beispielsweise die Anzahl von Tagen angeben, für die KDS-Einträge beibehalten werden, bevor sie aus der Datenbank gelöscht werden. Änderungen wie diese können mit dem Cmdlet Set-CsCdrConfiguration durchgeführt werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID, die der Auflistung von KDS-Konfigurationseinstellungen zugewiesen ist. 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.

Bei Auslassung dieses Parameters werden mit Set-CsCdrConfiguration die globalen Einstellungen geändert.

Instance

Optional

CdrSettings-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

EnableCDR

Optional

Boolescher Wert

Zeigt an, ob KDS aktiviert ist. Der Standardwert lautet "True".

EnablePurging

Optional

Boolescher Wert

Gibt an, ob KDS-Datensätze regelmäßig aus der KDS-Datenbank gelöscht werden. Wenn dieser Parameter auf "True" festgelegt ist (Standardeinstellung), werden Einträge nach dem Zeitraum gelöscht, der in den Eigenschaften "KeepCallDetailForDays" (KDS-Datensätze) und "KeepErrorReportForDays" (KDS-Fehler) angegeben ist. Bei Festlegung des Parameters auf "False" werden KDS-Einträge nie gelöscht.

KeepCallDetailForDays

Optional

Ganze Zahl

Gibt die Anzahl von Tagen an, die KDS-Datensätze in der KDS-Datenbank gespeichert werden. Einträge, die älter sind als angegeben, werden automatisch gelöscht. (Beachten Sie, dass der Löschvorgang nur stattfindet, wenn die Eigenschaft "EnablePurging" auf "True" festgelegt wurde.)

Sie können diese Eigenschaft auf einen beliebigen ganzzahligen Wert zwischen 1 und 2562 (etwa 7 Jahre) festlegen. Der Standardwert lautet 60.

KeepErrorReportForDays

Optional

Ganze Zahl

Gibt die Anzahl von Tagen an, für die KDS-Fehlerberichte beibehalten werden. Berichte, die älter sind als angegeben, werden automatisch gelöscht. KDS-Fehlerberichte sind Diagnoseberichte, die von Clientanwendungen wie z. B. Microsoft Lync 2010 hochgeladen werden.

Sie können diese Eigenschaft auf einen beliebigen ganzzahligen Wert zwischen 1 und 2562 (etwa 7 Jahre) festlegen. Der Standardwert lautet 60.

PurgeHourOfDay

Optional

Ganze Zahl

Gibt die lokale Uhrzeit an, zu der abgelaufene Einträge aus der KDS-Datenbank gelöscht werden. Die Tageszeit wird im 24-Stunden-Format angegeben, wobei 0 für Mitternacht und 23 für 23:00 Uhr steht. Beachten Sie, dass Sie nur die Stunde angeben können; das heißt, dass Sie den Löschvorgang auf 4:00 Uhr, jedoch nicht auf 4:30 Uhr oder 4:15 Uhr festlegen können. Der Standardwert lautet 2 (2:00 Uhr morgens). Es wird empfohlen, den Löschvorgang außerhalb der Geschäftszeiten durchzuführen.

Das Leeren der Datenbank erfolgt nur, wenn "EnablePurging" auf "True" festgelegt wurde.

Force

Optional

Switch-Parameter

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

WhatIf

Optional

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.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings. Set-CsCdrConfiguration akzeptiert eine weitergeleitete Eingabe von Konfigurationsobjekten für Kommunikationsdatensätze (KDS).

Rückgabetypen

Set-CsCdrConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CDRSettings" konfiguriert.

Beispiel

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

Set-CsCdrConfiguration -Identity site:Redmond -PurgeHourOfDay 23

Im vorstehenden Beispiel wird die Tageszeit für den Löschvorgang alter Datensätze festgelegt. In diesem Fall ist die Uhrzeit auf 23 (23:00 Uhr) festgelegt. Mit dem Parameter "Identity" wird sichergestellt, dass diese Änderungen nur an den KDS-Einstellungen mit dem Identitätswert "site:Redmond" vorgenommen werden.

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

Get-CsCdrConfiguration | Set-CsCdrConfiguration -PurgeHourOfDay 23

Beispiel 2 ist eine Variante des in Beispiel 1 gezeigten Befehls. In diesem Fall wird die Eigenschaft "PurgeHourOfDay" für jede Auflistung von KDS-Konfigurationseinstellungen geändert, die derzeit in der Organisation verwendet werden. Hierzu ruft der Befehl zunächst Get-CsCdrConfiguration ohne Parameter auf, um eine Auflistung aller derzeit verwendeten KDS-Einstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Set-CsCdrConfiguration weitergeleitet, das den Wert der Eigenschaft "PurgeHourOfDay" für jedes Element in der Auflistung in 23 (23:00 Uhr) ändert.

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

Get-CsCdrConfiguration -Filter "site:*"| Set-CsCdrConfiguration -PurgeHourOfDay 23

Beispiel 3 zeigt eine weitere Variante des Befehls aus Beispiel 1. In diesem Beispiel wird die Eigenschaft "PurgeHourOfDay" für alle KDS-Einstellungen geändert, die auf Standortebene konfiguriert wurden. Dazu ruft der Befehl zunächst Get-CsCdrConfiguration mit dem Parameter "Filter" auf. Der Filterwert "site:*" stellt sicher, dass nur KDS-Einstellungen mit einem Identitätswert herausgefiltert werden, der mit dem Zeichenfolgenwert "site:" beginnt. Die gefilterte Auflistung wird dann an Set-CsCdrConfiguration weitergeleitet, das die Eigenschaft "PurgeHourOfDay" der einzelnen Elemente der Auflistung ändert.