Set-CsAddressBookConfiguration

Syntax

Set-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsAddressBookConfiguration [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-Instance <PSObject>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-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 Set-CsAddressBookConfiguration können Sie jede in Ihrer Organisation verwendete Auflistung von Konfigurationseinstellungen für Adressbücher ändern.

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

Parameter

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings-Objekt. Set-CsAddressBookConfiguration akzeptiert eine weitergeleitete Eingabe von Adressbuchkonfigurationsobjekten.

Rückgabetypen

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

Beispiel

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

Set-CsAddressBookConfiguration -identity site:Redmond -RunTimeOfDay 23:00

In diesem Beispiel wird die Eigenschaft "RunTimeOfDay" festgelegt, die die Tageszeit auf 23:00 (11:00 PM im 24-Stunden-Format) festlegt, zu der die Adressbuchsynchronisierung stattfindet. Der Parameter "Identity" wird verwendet, um die Änderungen auf die Konfigurationseinstellungen für Adressbücher mit dem Identitätswert "site:Redmond" einzuschränken.

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

Get-CsAddressBookConfiguration -Filter site:* | Set-CsAddressBookConfiguration -RunTimeOfDay 23:00

In Beispiel 2 wird die Eigenschaft "RunTimeOfDay" auf 11:00 PM (23:00 Uhr) für alle Auflistungen von Adressbucheinstellungen festgelegt, die auf Standortebene konfiguriert wurden. Dazu ruft der Befehl zunächst Get-CsAddressBookConfiguration und den Parameter "Filter" auf, um eine Auflistung aller standortspezifischen Einstellungen zurückzugeben. Mit dem Filterwert "site:*" werden aus den zurückgegebenen Daten die Auflistungen herausgefiltert, die auf Standortebene konfiguriert wurden. Diese Informationen werden dann an Set-CsAddressBookConfiguration weitergeleitet, das den Wert der Eigenschaft "RunTimeOfDay" für jedes Element in der Auflistung ändert.

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

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

Mit dem vorstehenden Befehl wird die Eigenschaft "KeepDuration" für jede beliebige Auflistung von Adressbucheinstellungen geändert, bei der "KeepDuration" weniger als 30 Tage beträgt. Hierzu verwendet der Befehl Get-CsAddressBookConfiguration ohne zusätzliche Parameter, um eine Auflistung aller Adressbucheinstellungen 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 "KeepDuration" einen kleineren Wert als 30 Tage aufweist. Diese gefilterte Auflistung wird dann an Set-CsAddressBookConfiguration weitergeleitet, das den Wert der Eigenschaft "KeepDuration" für jedes Element in der Auflistung zu 30 Tagen ändert.

Siehe auch

Weitere Ressourcen

Get-CsAddressBookConfiguration
New-CsAddressBookConfiguration
Remove-CsAddressBookConfiguration