Freigeben über

  • Artikel

Remove-CsAddressBookConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt die angegebene Auflistung von Konfigurationseinstellungen für Adressbücher.

Syntax

Remove-CsAddressBookConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Adressbuchserver dienen als Mittler zwischen AD DS und Microsoft Lync Server 2010. Der Adressbuchserver stellt sicher, dass die in Lync Server 2010 gespeicherten Benutzerinformationen mit den in AD DS gespeicherten Benutzerinformationen synchronisiert sind. Hierzu werden die Adressbuchdateien regelmäßig mit den in der Benutzerdatenbank gespeicherten Informationen synchronisiert.

Darüber hinaus generieren Adressbuchserver regelmäßig Indexdateien, die auf die Computer mit Lync 2010 heruntergeladen werden. Wenn ein Benutzer nach Kontakten sucht, müssen entweder diese Indexdateien oder die Adressbuch-Indexdateien durchsucht werden, die im zentraler Verwaltungsspeicher gespeichert sind.

Adressbuchserver unterliegen Konfigurationseinstellungen für Adressbücher. Diese Einstellungen legen unter anderem fest, wie häufig Adressbuchserver mit der Benutzerdatenbank synchronisiert und wie oft Adressbuch-Indexdateien generiert werden. Bei der Installation von Lync Server wird automatisch ein Satz globaler Adressbucheinstellungen erstellt. Sie können aber auch benutzerdefinierte Konfigurationseinstellungen erstellen, die individuellen Standorten zugewiesen werden können. Diese Einstellungen gelten, sofern vorhanden, für alle Adressbuchserver an diesem Standort und haben Vorrang vor den globalen Einstellungen.

Mit dem Cmdlet New-CsAddressBookConfiguration können Sie auf Standortebene Konfigurationseinstellungen für Adressbücher erstellen. Zum späteren Entfernen von auf Standortebene konfigurierten Adressbucheinstellungen verwenden Sie das Cmdlet Remove-CsAddressBookConfiguration. Beachten Sie, dass Remove-CsAddressBookConfiguration auch für die globalen Einstellungen ausgeführt werden kann. Die globalen Einstellungen können jedoch nicht wirklich entfernt werden. Stattdessen werden beim Ausführen von Remove-CsAddressBookConfiguration für die globalen Einstellungen alle globalen Eigenschaften auf ihre Standardwerte zurückgesetzt.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-CsAddressBookConfiguration lokal auszufü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-CsAddressBookConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die zu entfernende Auflistung von Konfigurationseinstellungen für Adressbücher. Verwenden Sie folgende Syntax, um die globale Auflistung zu entfernen: -Identity global. (Wenn Sie die globalen Einstellungen "entfernen", setzen Sie im Grunde nur alle Eigenschaften auf deren Standardwerte zurück.) Verwenden Sie eine Syntax wie die folgende, um eine Standortauflistung zu entfernen: -Identity site:Redmond. Beachten Sie, dass Sie beim Festlegen eines Richtlinienidentitätswerts keine Platzhalter verwenden können.

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.AddressBook.AddressBookSettings-Objekt. Remove-CsAddressBookConfiguration akzeptiert eine weitergeleitete Eingabe von Anwesenheitsrichtlinienobjekten.

Rückgabetypen

Remove-CsAddressBookConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings" entfernt.

Beispiel

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

Remove-CsAddressBookConfiguration -Identity site:Redmond

In diesem Beispiel dient Remove-CsAddressBookConfiguration zum Löschen der Konfigurationseinstellungen für Adressbücher mit dem Identitätswert "site:Redmond". Die Verwendung des Parameters "Identity" stellt sicher, dass nur die angegebenen Adressbucheinstellungen entfernt werden.

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

Get-CsAddressBookConfiguration -Filter site:* | Remove-CsAddressBookConfiguration

In Beispiel 2 werden alle auf Standortebene konfigurierten Auflistungen von Adressbucheinstellungen entfernt. Zu diesem Zweck wird zunächst mit dem Cmdlet Get-CsAddressBookConfiguration eine Auflistung aller Adressbucheinstellungen zurückgegeben, die auf Standortebene konfiguriert wurden. Hierzu werden der Parameter "Filter" und der Filterwert "site:*" verwendet. Die abgerufene Auflistung wird dann an das Cmdlet Remove-CsAddressBookConfiguration weitergeleitet, das alle Elemente in der Auflistung entfernt.

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

Get-CsAddressBookConfiguration | Where-Object {$_.KeepDuration -lt 30.} | Remove-CsAddressBookConfiguration

Mit dem vorstehenden Befehl werden alle Adressbucheinstellungen entfernt, bei denen Änderungsdateien weniger als 30 Tage lang aufbewahrt wurden. Hier wird mit Get-CsAddressBookConfiguration eine Auflistung aller derzeit in Ihrer Organisation verwendeten Adressbucheinstellungen zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "KeepDuration" einen kleineren Wert als 30 Tage aufweist. (Achten Sie bei der Syntax darauf, dass auf die Anzahl der Tage ein Punkt folgt (30.).) Anschließend wird die gefilterte Auflistung an das Cmdlet Remove-CsAddressBookConfiguration weitergeleitet, das sämtliche Elemente in dieser Auflistung löscht.