Get-CsAddressBookConfiguration
トピックの最終更新日: 2012-03-23
アドレス帳の構成設定に関する情報を戻します。
構文
Get-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAddressBookConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
アドレス帳サーバーは、Active Directory ドメイン サービス (AD DS) と Microsoft Lync Server 2010 の間の仲介となります。アドレス帳サーバーは、Lync Server 2010 に保存されているユーザー情報と Active Directory に保存されているユーザー情報が、確実に同期するようにします。これを実行するには、アドレス帳ファイルをユーザー データベースに保存されている情報と定期的に同期します。
さらに、アドレス帳サーバーは定期的にインデックス ファイルを生成し、Lync 2010 を実行しているコンピューターにそれらのファイルをダウンロードします。ユーザーが連絡先を検索する場合は、そのインデックス ファイルを検索するか、中央管理ストアに保存されているアドレス帳のインデックス ファイルを検索します。
アドレス帳サーバーは、アドレス帳の構成設定を使用して管理されます。これらの設定によって、アドレス帳ファイルがユーザー データベースと同期される頻度やアドレス帳のインデックス ファイルが生成される頻度などが決定されます。Lync Server 2010 をインストールするときに、一連のグローバル アドレス帳設定が作成されます。カスタムの構成設定を作成して、個々のサイトに適用することもできます。これらの設定が存在する場合は、そのサイト内で動作しているすべてのアドレス帳サーバーに適用され、グローバル設定より優先されます。
Get-CsAddressBookConfiguration コマンドレットを使用して、組織で現在使用されているアドレス帳設定のいずれか (またはすべて) に関する情報を戻すことができます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsAddressBookConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAddressBookConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsIdentity |
戻されるアドレス帳設定のコレクションに対応する一意の識別子です。グローバル設定を参照するには、次の構文を使用します。-Identity global。サイト スコープで構成されるコレクションを参照するには、次のような構文を使用します。-Identity site:Redmond。 Identity 指定時はワイルドカードを使用できないことに注意してください。ワイルドカードを使用する必要がある場合は、代わりに Filter パラメーターを指定します。 このパラメーターを指定しない場合は、Get-CsAddressBookConfiguration を実行すると、組織で使用されているすべてのアドレス帳設定のコレクションが戻されます。 |
Filter |
省略可能 |
文字列 |
アドレス帳設定のコレクション (1 つまたは複数) を戻すために、ワイルドカード文字を使用できます。たとえば、サイト スコープで構成されているすべての設定のコレクションを戻すには、次の構文を使用します。-Filter site:*。Identity の一部の文字列値が "EMEA" であるすべての設定のコレクションを戻すには、次の構文を使用します。-Filter *EMEA*。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
中央管理ストア自体からではなく、中央管理ストアのローカル レプリカからアドレス帳構成構成データを取得します。 |
入力の種類
なし。Get-CsAddressBookConfiguration はパイプライン処理された入力を受け入れません。
戻り値の種類
Get-CsAddressBookConfiguration を実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 --------------------------
Get-CsAddressBookConfiguration
上記の例では、組織で使用されているすべてのアドレス構成設定に関する情報を戻します。これは、追加パラメーターを指定せずに Get-CsAddressBookConfiguration を呼び出した場合の、既定の動作です。
-------------------------- 例 2 --------------------------
Get-CsAddressBookConfiguration -Identity site:Redmond
例 2 では、site:Redmond という Identity を持つアドレス帳構成設定に関する情報を戻します。
-------------------------- 例 3 --------------------------
Get-CsAddressBookConfiguration -Filter site:*
上記の例では、Filter パラメーターとフィルター値 "site:*" を使用して、サイト スコープで適用されているすべてのアドレス帳構成設定に関する情報を戻します。指定したフィルター値によって、先頭が "site:" という文字列の Identity を持つすべてのアドレス帳設定に関する情報を戻します。
-------------------------- 例 4 --------------------------
Get-CsAddressBookConfiguration | Where-Object {$_.UseNormalizationRules -eq $True}
例 4 では、電話番号を解析するときにアドレス帳構成設定によって正規化ルールが使用される、すべてのアドレス帳構成設定を戻します。これを行うために、コマンドでまず、Get-CsAddressBookConfiguration を使用して組織内のすべてのアドレス帳設定のコレクションを戻します。このコレクションが Where-Object コマンドレットにパイプ処理され、UseNormalizationRules プロパティが True と等しい設定のみが選択されます。