Freigeben über

  • Artikel

New-CsArchivingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Erstellt einen neuen Satz mit Instant Messaging-Archivierungseinstellungen. Diese Einstellungen dienen zum Aktivieren bzw. Deaktivieren der automatischen Speicherung von Instant Messaging-Sitzungen. Sie ermöglichen ferner das Blockieren von Sofortnachrichten, die nicht archiviert werden können.

Syntax

New-CsArchivingConfiguration -Identity <XdsIdentity> [-ArchiveDuplicateMessages <$true | $false>] [-BlockOnArchiveFailure <$true | $false>] [-CachePurgingInterval <UInt32>] [-Confirm [<SwitchParameter>]] [-EnableArchiving <None | ImOnly | ImAndWebConf>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-KeepArchivingDataForDays <UInt32>] [-PurgeExportedArchivesOnly <$true | $false>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

In vielen Organisationen wird eine Aufzeichnung aller Instant Messaging-Sitzungen, die von den Benutzern durchgeführt wurden, als sinnvoll erachtet. Für andere Organisationen ist es verbindlich, solche Aufzeichnungen zu erstellen. In der Finanzwelt sind beispielsweise viele Unternehmen gesetzlich verpflichtet, Kopien ihrer gesamten elektronischen Kommunikation zu erstellen.

Mit Microsoft Lync Server 2010 können Sie Instant Messaging- und Webkonferenzsitzungen flexibel archivieren. Falls Sie Archivierungsserver bereitgestellt haben, können Sie mit den verschiedenen CsArchivingConfiguration-Cmdlets die Archivierung von Instant Messaging-Sitzungen aktivieren und deaktivieren sowie Ihre Archivierungsdatenbank verwalten. Außerdem können Sie Instant Messaging zeitweilig unterbrechen, wenn bei der Archivierung ein Fehler auftreten sollte. Dadurch wird sichergestellt, dass Sie eine Aufzeichnung sämtlicher elektronischer Kommunikation beibehalten.

Bei der Installation von Lync Server 2010 wird eine Auflistung globaler Archivierungseinstellungen erstellt, die standardmäßig für die gesamte Organisation gelten. Sie können auch das Cmdlet New-CsArchivingConfiguration verwenden, um benutzerdefinierte Konfigurationseinstellungen individuell für einzelne Standorte zu erstellen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID, die einer neuen Auflistung von Archivierungskonfigurationseinstellungen zugewiesen werden soll. Da Sie neue Auflistungen nur auf Standortebene erstellen können, weist der Identitätswert immer das Präfix "site:" auf, gefolgt vom Standortnamen, z. B. "site:Redmond".

ArchiveDuplicateMessages

Optional

Boolescher Wert

Gibt an, wie poolübergreifende Sofortnachrichten archiviert werden sollen. Beispielsweise sendet Ken Myer (mit einem Konto in Pool 1) eine Sofortnachricht an Pilar Ackerman (mit einem Konto in Pool 2). Pilar sendet anschließend eine Antwort auf Kens Sofortnachricht. Falls "ArchiveDuplicateMessages" auf "False" festgelegt ist, wird die Sitzungsaufzeichnung (basierend auf einem vordefinierten Algorithmus) entweder in Pool 1 oder Pool 2, aber nicht in beiden Pools protokolliert. Ist "ArchiveDuplicateMessages" auf "True" (den Standardwert) festgelegt, wird die Aufzeichnung in beiden Pools protokolliert.

BlockOnArchiveFailure

Optional

Boolescher Wert

Bei Festlegung auf "True" wird der Instant Messaging-Dienst immer dann angehalten, wenn Sofortnachrichtensitzungen nicht archiviert werden können. Bei Festlegung auf "False" (Standardwert) wird das Instant Messaging fortgesetzt, auch wenn Sitzungen nicht archiviert werden können.

CachePurgingInterval

Optional

Ganze Zahl

Gibt an, wie oft (in Stunden) Aufzeichnungen aus dem System gelöscht werden, die zu Teilnehmern gehören, die nicht für die Archivierung aktiviert wurden. Prinzipiell werden alle Instant Messaging- und -Konferenzsitzungen von Gruppen aufgezeichnet. Im angegebenen Intervall überprüft das System, ob Teilnehmer an diesen Sitzungen für die Archivierung aktiviert waren. Wenn das System eine Sitzung findet, deren Teilnehmer nicht für die Archivierung aktiviert waren, wird die dazugehörige Aufzeichnung aus der Datenbank gelöscht.

Die Eigenschaft "CachePurgeInterval" kann auf einen beliebigen ganzzahligen Wert von 4 bis 168 festgelegt werden. Der Standardwert lautet 24.

EnableArchiving

Optional

Zeichenfolge

Gibt an, welche Elemente gegebenenfalls in der Archivierungsdatenbank gespeichert werden. Gültige Werte:

None. In der Datenbank werden keine Elemente archiviert. Dies ist der Standardwert.

ImOnly. Instant Messaging-Sitzungen werden in der Datenbank archiviert.

ImAndWebConf. Instant Messaging- und Webkonferenzsitzungen werden in der Datenbank archiviert.

EnablePurging

Optional

Boolescher Wert

Bei Festlegung auf "True" werden archivierte Sofortnachrichten regelmäßig aus der Datenbank entfernt, sofern Folgendes gilt: Die Sofortnachrichten sind 1) älter als der für die Eigenschaft "KeepArchivingDataForDays" angegebene Wert oder wurden 2) exportiert und für das Löschen markiert.

Bei Festlegung auf "False" werden Sofortnachrichten nicht automatisch aus der Datenbank gelöscht.

KeepArchivingDataForDays

Optional

Ganze Zahl

Anzahl der Tage (1 bis 2562), die archivierte Sofortnachrichten in der Datenbank verbleiben, bevor sie automatisch gelöscht werden. Der Standardwert lautet 14.

Diese Eigenschaft wird nur wirksam, wenn "EnablePurging" auf "True" festgelegt wurde.

PurgeExportedArchivesOnly

Optional

Boolescher Wert

Bei Festlegung auf "True" löscht das System nur Sofortnachrichten, die exportiert wurden (und infolgedessen für das Löschen markiert wurden). Nicht exportierte Sofortnachrichten verbleiben in der Datenbank, auch wenn diese älter als der für die Eigenschaft "KeepArchivingDataForDays" angegebene Wert sind.

PurgeHourOfDay

Optional

Ganze Zahl

Gibt die Uhrzeit an, zu der abgelaufene Datensätze aus der Archivierungsdatenbank gelöscht werden. Die Uhrzeit wird im 24-Stunden-Format angegeben, wobei Mitternacht (12:00 AM) durch 0 und 11:00 PM durch 23 dargestellt wird. Beachten Sie, dass Sie nur die volle Stunde angeben können. Dies bedeutet, dass Sie das Leeren der Datenbank für 4:00 Uhr, aber nicht für 4:15 Uhr oder 4:30 Uhr planen können. Der Standardwert lautet 2 (2:00 Uhr).

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.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine. New-CsArchivingConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsArchivingConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings" erstellt.

Beispiel

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

New-CsArchivingConfiguration -Identity site:Redmond -EnableArchiving "ImOnly"

Der Befehl in Beispiel 1 erstellt eine neue Auflistung von Archivierungskonfigurationseinstellungen für den Standort "Redmond". Durch Hinzufügen des Parameters "EnableArchiving" und Festlegen des Parameterwerts auf "ImOnly" aktiviert der Befehl auch die Archivierung von Instant Messaging-Sitzungen, aber nicht von Webkonferenzen für den Standort Redmond.

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

$x = New-CsArchivingConfiguration -Identity site:Redmond -InMemory
$x.EnableArchiving = "ImOnly"
Set-CsArchivingConfiguration -Instance $x

Im vorstehenden Beispiel wird gezeigt, wie Sie den Parameter "-InMemory" zum Erstellen einer neuen Auflistung von Archivierungskonfigurationseinstellungen verwenden können, die zunächst nur im Arbeitsspeicher vorhanden sind. Hierzu erstellt der Befehl eine neue Einstellungsauflistung (mit dem Identitätswert "site:Redmond"), die in der Variablen "$x" gespeichert wird. Beachten Sie, dass die Auflistung nach Ausführen dieses ersten Befehls nur im Arbeitsspeicher vorhanden ist. Wenn Sie den Befehl Get-CsArchivingConfiguration ausführen, wird kein Eintrag für "site:Redmond" angezeigt.

Der zweite Befehl legt die Eigenschaft "EnableArchiving" für diese virtuelle Einstellungsauflistung auf "ImOnly" fest, wodurch die Instant Messaging-Sitzungsarchivierung aktiviert wird. Der letzte Befehl verwendet schließlich Set-CsArchivingConfiguration, um die virtuelle Auflistung von Archivierungseinstellungen in eine tatsächliche Auflistung von Einstellungen für den Standort "Redmond" umzuwandeln. Wenn Sie Set-CsArchivingConfiguration nicht aufrufen, sind diese Einstellungen nur im Arbeitsspeicher vorhanden und gehen verloren, sobald Sie die Windows PowerShell-Sitzung beenden oder die Variable "$x" löschen.