Freigeben über

  • Artikel

Set-CsArchivingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ändert eine bestehende Auflistung von Archivierungseinstellungen für Sofortnachrichten.

Syntax

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

Set-CsArchivingConfiguration [-ArchiveDuplicateMessages <$true | $false>] [-BlockOnArchiveFailure <$true | $false>] [-CachePurgingInterval <UInt32>] [-Confirm [<SwitchParameter>]] [-EnableArchiving <None | ImOnly | ImAndWebConf>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepArchivingDataForDays <UInt32>] [-PurgeExportedArchivesOnly <$true | $false>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Viele Organisationen finden es sinnvoll, alle Sofortnachrichtensitzungen und Konferenzen aufzuzeichnen, an denen ihre Benutzer teilnehmen. Bei anderen Organisationen sind solche Aufzeichnungen obligatorisch. So sind beispielsweise viele Organisationen im Finanzwesen gesetzlich verpflichtet, Kopien sämtlicher elektronischer Kommunikation aufzubewahren.

Um Sofortnachrichten zu archivieren, müssen Sie mindestens einen Archivierungsserver einrichten. Nach dem Einrichten des Archivierungsservers müssen Sie zwei zusätzliche Schritte ausführen. Zuerst müssen Sie die Archivierung auf globaler Ebene aktivieren. (Einzelheiten hierzu finden Sie im Thema Set-CsArchivingConfiguration.) Optional können Sie auch benutzerdefinierte Archivierungseinstellungen für verschiedene Standorte konfigurieren.

Außerdem müssen Sie Archivierungsrichtlinien verwenden, um anzugeben, für welche Benutzer die Sofortnachrichtensitzungen archiviert werden. Sofortnachrichtensitzungen werden erst dann archiviert, wenn eine Richtlinie vorliegt, welche die Archivierung von Sofortnachrichtensitzungen erfordert.

Bei der Installation von Lync Server 2010 wird eine Auflistung globaler Archivierungskonfigurationseinstellungen 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. In beiden Fällen können Sie mit dem Cmdlet Set-CsArchivingConfiguration die Eigenschaftswerte einer vorhandenen Auflistung von Konfigurationseinstellungen für die Archivierung ändern.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Stellt die eindeutige ID der zu ändernden Auflistung von Archivierungskonfigurationseinstellungen dar. Zum Ändern der globalen Einstellungen lassen Sie entweder diesen Parameter aus oder verwenden die folgende Syntax: -Identity global. Zum Ändern der Einstellungen auf Standortebene verwenden Sie das Präfix "site:" gefolgt von dem Standortnamen. Beispiel: -Identity "site:Redmond".

Instance

Optional

ArchivingSettings-Objekt

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

ArchiveDuplicateMessages

Optional

Boolescher Wert

Gibt an, wie poolübergreifende Sofortnachrichten archiviert werden sollen. Ein einfaches Beispiel: Ken Myer (mit einem Konto in Pool 1) sendet eine Sofortnachricht an Pilar Ackerman (mit einem Konto in Pool 2), und Ackerman sendet eine Antwort auf Myers 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 Sofortnachrichten nicht archiviert werden können. Bei Festlegung auf "False" (Standardwert) wird die Sofortnachrichtensitzung auch dann fortgesetzt, wenn Sofortnachrichten 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. Das System überprüft im angegebenen Intervall, 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.

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.Archiving.ArchivingSettings-Objekt. Set-CsArchivingConfiguration akzeptiert eine weitergeleitete Eingabe von Archivierungskonfigurationsobjekten.

Rückgabetypen

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

Beispiel

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

Set-CsArchivingConfiguration -Identity site:Redmond -ArchiveDuplicateMessages $False -KeepArchivingDataForDays 30

Im vorstehenden Beispiel wird Set-CsArchivingConfiguration zum Ändern zweier Eigenschaften der Archivierungskonfigurationseinstellungen verwendet, die den Identitätswert "site:Redmond" aufweisen. Der Befehl legt zunächst die Eigenschaft "ArchiveDuplicateMessages" auf "False" fest; dies verhindert, dass der Server dieselbe Sofortnachricht mehrfach archiviert. Außerdem verwendet der Befehl den Parameter "KeepArchivingDataForDays", um den Server anzuweisen, Sofortnachrichten für 30 Tage aufzubewahren.

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

Get-CsArchivingConfiguration -Filter "site:*" | Set-CsArchivingConfiguration -ArchiveDuplicateMessages $False -KeepArchivingDataForDays 30

Beispiel 2 stellt eine Variante des Befehls in Beispiel 1 dar: In diesem Fall werden die Werte der Eigenschaften "ArchiveDuplicateMessages" und "KeepArchivingDataForDays" jedoch für alle Archivierungseinstellungen geändert, die auf Standortebene konfiguriert wurden. Hierzu gibt der Befehl zunächst mit Get-CsArchivingConfiguration und dem Parameter "Filter" eine Auflistung aller Archivierungseinstellungen zurück, die auf Standortebene konfiguriert wurden. Der Filterwert "site:*" stellt sicher, dass nur Einstellungen zurückgegeben werden, deren Identitätswert mit den Zeichen "site:" beginnt. Die gefilterte Auflistung wird dann an das Cmdlet Set-CsArchivingConfiguration weitergeleitet, das die zwei Eigenschaftswerte der einzelnen Elemente der Auflistung ändert.

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

Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -eq "ImAndWebConf"} | Set-CsArchivingConfiguration -EnableArchiving "ImOnly"

In Beispiel 3 werden alle Archivierungskonfigurationseinstellungen geändert, die sowohl die Sofortnachrichtensitzungs- als auch die Webkonferenzarchivierung zulassen; nach Abschluss des Befehls lassen diese Einstellungen nur die Sofortnachrichtensitzungsarchivierung zu. Dazu ruft der Befehl zunächst Get-CsArchivingConfiguration ohne Parameter auf, um eine Auflistung aller in der Organisation verwendeten Archivierungskonfigurationseinstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "EnableArchiving" den Wert "ImAndWebConf" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Die Auflistung wird dann an das Cmdlet Set-CsArchivingConfiguration weitergeleitet, das für jedes Element in der Auflistung die Eigenschaft "EnableArchiving" auf "ImOnly" festlegt.