• Artikel

Get-CsAddressBookConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu Konfigurationseinstellungen für Adressbücher zurück.

Syntax

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

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

Detaillierte Beschreibung

Adressbuchserver dienen als Mittler zwischen Active Directory-Domänendienste (AD DS) und Microsoft Lync Server 2010. Der Adressbuchserver stellt sicher, dass die in Lync Server 2010 gespeicherten Benutzerinformationen mit den in Active Directory gespeicherten Benutzerinformationen synchronisiert sind. Dies wird erreicht, indem die Adressbuchdateien regelmäßig mit den in der Benutzerdatenbank gespeicherten Informationen synchronisiert werden.

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 2010 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.

Sie können das Cmdlet Get-CsAddressBookConfiguration verwenden, um Informationen zu beliebigen (oder allen) derzeit in Ihrer Organisation verwendeten Adressbucheinstellungen zurückzugeben.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsAddressBookConfiguration lokal auszufü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 rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAddressBookConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zurückzugebende Auflistung von Adressbucheinstellungen. 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-CsAddressBookConfiguration eine Auflistung aller derzeit in der Organisation verwendeten Adressbucheinstellungen zurück.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen, um eine Auflistung (oder mehrere Auflistungen) von Adressbucheinstellungen zurückzugeben. Verwenden Sie beispielsweise folgende Syntax, um eine Auflistung aller auf der Standortebene konfigurierten Einstellungen zurückzugeben. -Filter site:*. Verwenden Sie folgende Syntax, um eine Auflistung aller Einstellungen zurückzugeben, deren Identitätswert den Zeichenfolgenwert "EMEA" aufweist: -Filter *EMEA*.

LocalStore

Optional

Switch-Parameter

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

Eingabetypen

Keine. Get-CsAddressBookConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsAddressBookConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings" zurückgegeben.

Beispiel

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

Get-CsAddressBookConfiguration

Im vorstehenden Beispiel werden Informationen zu allen in Ihrer Organisation verwendeten Konfigurationseinstellungen für Adressbücher zurückgegeben. Dies ist das Standardverhalten beim Aufrufen von Get-CsAddressBookConfiguration ohne zusätzliche Parameter.

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

Get-CsAddressBookConfiguration -Identity site:Redmond

In Beispiel 2 werden Informationen zum Adressbuch-Konfigurationseinstellungen mit dem Identitätswert "site:Redmond" zurückgegeben.

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

Get-CsAddressBookConfiguration -Filter site:*

Im vorstehenden Beispiel werden der Parameter "Filter" und der Filterwert "site:*" verwendet, um Informationen zu allen Adressbuch-Konfigurationseinstellungen zurückzugeben, die auf Standortebene konfiguriert sind. Der angegebene Filterwert gibt Informationen zu allen Adressbucheinstellungen zurück, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt.

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

Get-CsAddressBookConfiguration | Where-Object {$_.UseNormalizationRules -eq $True}

In Beispiel 4 werden Informationen zu allen Konfigurationseinstellungen für Adressbücher zurückzugeben, bei denen die Einstellungen beim Analysieren von Telefonnummern Normalisierungsregeln verwenden. Zu diesem Zweck verwendet der Befehl zunächst Get-CsAddressBookConfiguration, um eine Auflistung aller Adressbucheinstellungen in der Organisation zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "UseNormalizationRules" den Wert "True" aufweist.