Get-CsRegistrarConfiguration
トピックの最終更新日: 2012-03-23
現在組織で使用中のレジストラー構成設定に関する情報を戻します。レジストラーは、ログオン要求の認証と、ユーザーの状態や連絡可能性に関する情報の維持のために使用されます。
構文
Get-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsRegistrarConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
レジストラーは、おそらく Microsoft Lync Server 2010 の中で最も重要なコンポーネントです。結局のところ、レジストラーがなければ、ユーザーはシステムにログオンできず、Lync Server 2010 はユーザーの追跡とユーザーの現在の状態の把握を行うことができないからです。Lync Server にユーザーがログオンすると、ユーザーがログオンしたエンドポイントは REGISTER 要求をレジストラーに送信します。次に、そのサーバーは、クライアント デバイスに認証資格情報をチャレンジすることによって応答します。クライアントがチャレンジをパスすると (つまり、クライアントが有効な資格情報のセットを提出すると)、ユーザーは認証され、IP アドレス、ポート、およびユーザー名などのエンドポイント情報が登録データベースに記録されます。ユーザーがログオフすると、この情報はデータベースから削除されます。ログオンからログオフまでの間、レジストラーは最新の状態情報を保持し、ユーザー間でのメッセージのルーティングを支援します。
レジストラー構成設定を使用して、エンドポイントとエンドポイント サブスクリプションを管理することができます。これらの設定は、グローバル スコープ、サイト スコープ、またはサービス スコープで適用できます(サービス スコープ設定は、レジストラー サービスでのみ使用できます)。現在組織で使用中のすべてのレジストラー構成コレクションに関する情報を戻す場合は、Get-CsRegistrarConfiguration コマンドレットを使用します。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Get-CsRegistrarConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRegistrarConfiguration"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
省略可能 |
Xds Identity |
戻されるレジストラー構成設定の一意の識別子です。グローバル設定を戻すには、次の構文を使用します。-Identity global。サイト スコープで構成された設定を返すには、次のような構文を使用します。-Identity site:Redmond。サービス レベルの設定を戻すには、次のような構文を使用します。-Identity service:Registrar:atl-cs-001.litwareinc.com。 このパラメーターを省略すると、Get-CsRegistrarConfiguration により、組織で現在使用中のすべてのレジストラー構成設定が戻されます。 |
Filter |
省略可能 |
文字列 |
ワイルドカードを使用して、1 つまたは複数のレジストラー構成設定のコレクションを戻すことができます。たとえば、サイト スコープで構成されているすべての設定を戻すには、次の構文を使用します。-Filter "site:*"。サービス スコープで構成されたすべての設定を戻すには、次の構文を使用します。-Filter "service:*"。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
中央管理ストア自体からではなく、中央管理ストアのローカル レプリカから、レジストラー構成設定データを取得します。 |
入力の種類
なし。Get-CsRegistrarConfiguration は、パイプライン処理された入力を受け入れません。
戻り値の種類
Get-CsRegistrarConfiguration を実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 --------------------------
Get-CsRegistrarConfiguration
例 1 に示すコマンドは、現在組織で使用中のすべてのレジストラー構成設定のコレクションを戻します。
-------------------------- 例 2 --------------------------
Get-CsRegistrarConfiguration -Identity site:Redmond
例 2 では、Redmond サイト (-Identity site:Redmond) で構成されたレジストラー構成設定の 1 つのコレクションを戻します。
-------------------------- 例 3 --------------------------
Get-CsRegistrarConfiguration -Filter "service:*"
例 3 では、サービス スコープで割り当てられたすべてのレジストラー構成設定の情報を戻します。このタスクを実行するには、コマンドで Filter パラメーターおよびフィルター値"service:*" を使用します。このフィルター値により、文字列値 "service:" で始まる Identity を持つ設定のみが戻されます。
-------------------------- 例 4 --------------------------
Get-CsRegistrarConfiguration | Where-Object {$_.EnableDHCPServer -eq $True}
例 4 では、クライアントを登録するために DHCP サーバーを使用可能にするレジストラー構成設定に関する情報を戻します。このタスクを実行するには、コマンドではまず、パラメーターを指定せずに Get-CsRegistrarConfiguration を呼び出します。これにより、現在使用中のすべてのレジストラー構成設定のコレクションが戻されます。次に、このコレクションを Where-Object にパイプ処理して、EnableDHCPServer プロパティが True と等しい設定のみを選択します。
-------------------------- 例 5 --------------------------
Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8}
上記のコマンドでは、ユーザーあたり 8 個を超えるエンドポイントを許可するすべてのレジストラー構成設定の情報を戻します。このタスクを実行するには、まず Get-CsRegistrarConfiguration を使用して、組織で使用されているすべてのレジストラー構成設定のコレクションを戻します。このコレクションは Where-Object コマンドレットにパイプ処理され、それにより、MaxEndpointsPerUser プロパティが 8 を超える設定のみが選択されます。