Freigeben über

  • Artikel

Get-CsArchivingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen dazu zurück, wie (oder ob) Instant Messaging-Sitzungen (Sofortnachrichten) in Ihrer Organisation archiviert werden.

Syntax

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

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

Detaillierte Beschreibung

Viele Organisationen erachten es als sinnvoll, alle Instant Messaging-Sitzungen ihrer Benutzer (oder bestimmter Benutzergruppen) aufzuzeichnen. In anderen Organisationen sind derartige Aufzeichnungen obligatorisch. So sind beispielsweise viele Organisationen im Finanzwesen gesetzlich verpflichtet, Kopien sämtlicher elektronischer Kommunikation aufzubewahren.

Mit Microsoft Lync Server 2010 können Sie Instant Messaging- und Webkonferenzsitzungen flexibel archivieren. Wenn Sie die Archivierungsserver bereitgestellt haben, können Sie mithilfe verschiedener CsArchivingConfiguration-Cmdlets die Archivierung von Sofortnachrichten aktivieren und deaktivieren und 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.

Um Sofortnachrichtensitzungen archivieren zu können, müssen Sie mindestens eine Archivierungsserver einrichten. Nach dem Einrichten des Archivierungsservers müssen Sie zwei zusätzliche Schritte ausführen. Zunächst müssen Sie die Archivierung auf der entsprechenden Ebene aktivieren (Einzelheiten finden Sie im Thema Set-CsArchivingConfiguration). Dabei könnte es sich um die globale Ebene handeln. Sie können jedoch 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. Was geschieht, wenn Sie die Archivierung aktivieren, aber keinen Benutzern eine Richtlinie zuweisen, die die Archivierung ihrer Sofortnachrichtensitzungen festlegt? In diesem Fall geschieht nichts. Sofortnachrichtensitzungen werden erst dann archiviert, wenn eine Richtlinie vorliegt, welche die Archivierung von Sofortnachrichtensitzungen erfordert.

Mit dem Cmdlet Get-CsArchivingConfiguration können Sie ermitteln, wie die Sofortnachrichtensitzungsarchivierung in Ihrer Organisation konfiguriert ist.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Gibt die eindeutige ID für die Auflistung der zurückzugebenden Archivierungseinstellungen 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-CsArchivingConfiguration eine Auflistung aller derzeit in der Organisation verwendeten Archivierungskonfigurationseinstellungen zurück.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen, um eine Auflistung (oder mehrere Auflistungen) von Archivierungskonfigurationseinstellungen zurückzugeben. Verwenden Sie folgende Syntax, um eine Auflistung aller auf Standortebene konfigurierten Einstellungen zurückzugeben: -Filter site:*. Verwenden Sie folgende Syntax, um eine Auflistung aller Einstellungen zurückzugeben, deren Identitätswert (die einzige Eigenschaft, nach der gefiltert werden kann) den Zeichenfolgenwert "Canada" aufweist: -Filter "*Canada*".

LocalStore

Optional

Switch-Parameter

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

Eingabetypen

Keine. Get-CsArchivingConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsArchivingConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings" zurückgegeben.

Beispiel

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

Get-CsArchivingConfiguration

Der Befehl in Beispiel 1 gibt eine Auflistung aller Archivierungskonfigurationseinstellungen zurück, die in Ihrer Organisation verwendet werden.

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

Get-CsArchivingConfiguration -Identity site:Redmond

Im vorstehenden Beispiel wird die zurückgegebene Auflistung von Archivierungskonfigurationseinstellungen mit dem Parameter "Identity" auf die Einstellungen mit dem Identitätswert "site:Redmond" beschränkt.

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

Get-CsArchivingConfiguration -Filter site:*

In Beispiel 3 wird die zurückgegebene Auflistung von Archivierungskonfigurationseinstellungen mit dem Parameter "Filter" auf die Einstellungen beschränkt, die auf Standortebene konfiguriert wurden. Der Parameterwert "site:*" beschränkt die zurückgegebenen Elemente auf diejenigen, deren Identitätswert mit der Zeichenfolge "site:" beginnt.

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

Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -ne "None"}

In diesem Beispiel wird Get-CsArchivingConfiguration verwendet, um eine Auflistung aller Archivierungskonfigurationseinstellungen zurückzugeben, die für die Verwendung in Ihrer Organisation aktiviert sind. Dazu ruft der Befehl zunächst Get-CsArchivingConfiguration ohne Parameter auf, um eine Auflistung aller Archivierungskonfigurationseinstellungen zurückzugeben. Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet, das einen Filter anwendet, um die zurückgegebenen Daten auf Auflistungen zu beschränken, bei denen die Eigenschaft "EnableArchiving" nicht den Wert "None" aufweist. Ist "EnableArchiving" auf "None" festgelegt, ist die Archivierung deaktiviert. Weist diese Eigenschaft einen anderen Wert auf ("IMOnly" oder "ImAndWebConf"), ist die Archivierung aktiviert.