Remove-CsArchivingConfiguration
Letztes Änderungsdatum des Themas: 2012-03-27
Entfernt die angegebene Auflistung von Archivierungseinstellungen. Archivierungseinstellungen dienen zum Aktivieren und Deaktivieren des automatischen Speicherns von Instant Messaging-Sitzungen sowie zum optionalen Sperren beliebiger Sofortnachrichten, die nicht archiviert werden können.
Syntax
Remove-CsArchivingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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.
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. Alle mit New-CsArchivingConfiguration erstellten standortspezifischen Einstellungen können später mit dem Cmdlet Remove-CsArchivingConfiguration entfernt werden. Wenn Sie Einstellungen für einen Standort entfernen, unterliegt der betreffende Standort den globalen Einstellungen.
Beachten Sie, dass Sie das Cmdlet Remove-CsArchivingConfiguration auch für globale Archivierungseinstellungen ausführen können. In diesem Fall werden die Einstellungen jedoch nicht entfernt, da die globalen Einstellungen nicht gelöscht werden können. Stattdessen werden alle globalen Eigenschaften auf ihre Standardwerte zurückgesetzt. Nehmen Sie beispielsweise an, Sie haben die Archivierung von Instant Messaging-Sitzungen auf globaler Ebene aktiviert und führen einige Zeit später den Befehl "Remove-CsArchivingConfiguration -Identity global" aus. Durch Ausführen dieses Befehls werden die Eigenschaftswerte für die globalen Einstellungen zurückgesetzt, d. h. "EnableArchiving" wird auf den Standardwert "None" zurückgesetzt. Dadurch wiederum wird die Archivierung auf globaler Ebene deaktiviert.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-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 "Remove-CsArchivingConfiguration"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Die eindeutige ID der Auflistung von Archivierungskonfigurationseinstellungen, die entfernt werden sollen. Verwenden Sie folgende Syntax, um die globale Auflistung zu entfernen: -Identity global. (Beachten Sie, dass Sie die globalen Einstellungen nicht wirklich entfernen können. Stattdessen können Sie nur die Eigenschaften auf ihre Standardwerte zurücksetzen.) Verwenden Sie eine Syntax wie die folgende, um eine Standortauflistung zu entfernen: -Identity site:Redmond. Sie können beim Angeben einer Richtlinienidentität keine Platzhalter verwenden. |
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. "Remove-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" entfernt.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsArchivingConfiguration -Identity site:Redmond
Im vorstehenden Beispiel werden mit Remove-CsArchivingConfiguration die Archivierungskonfigurationseinstellungen mit der Identität "site:Redmond" gelöscht.
-------------------------- Beispiel 2 --------------------------
Get-CsArchivingConfiguration -Filter "site:*" | Remove-CsArchivingConfiguration
Der Befehl in Beispiel 2 entfernt alle Archivierungskonfigurationseinstellungen, die auf Standortebene konfiguriert wurden. Zu diesem Zweck gibt der Befehl zunächst mithilfe von Get-CsArchivingConfiguration und dem Parameter "Filter" eine Auflistung aller auf Standortebene konfigurierten Einstellungen zurück. Dazu wird der Filterwert "site:*" verwendet, der die zurückgegebenen Daten auf Einstellungen beschränkt, deren Identität mit der Zeichenfolge "site:" beginnt. Die gefilterte Auflistung wird dann an Remove-CsArchivingConfiguration weitergeleitet, um sämtliche Elemente in der Auflistung zu löschen.
-------------------------- Beispiel 3 --------------------------
Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -eq "None"} | Remove-CsArchivingConfiguration
In Beispiel 3 werden alle Archivierungskonfigurationseinstellungen gelöscht, bei denen die Eigenschaft "EnableArchiving" auf "None" festgelegt ist. Dazu wird Get-CsArchivingConfiguration ohne Parameter aufgerufen, um eine Auflistung aller Archivierungseinstellungen zurückzugeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "EnableArchiving" den Wert "None" aufweist. Die gefilterte Auflistung wird dann an Remove-CsArchivingConfiguration weitergeleitet, um sämtliche Elemente in der Auflistung zu löschen.
Siehe auch
Weitere Ressourcen
Get-CsArchivingConfiguration
New-CsArchivingConfiguration
Set-CsArchivingConfiguration
Set-CsArchivingServer