Get-CsAutodiscoverConfiguration
トピックの最終更新日: 2012-04-23
組織で現在使用されている自動検出構成設定に関する情報を戻します。自動検出サービスとは、Lync Web Access、Microsoft Lync Mobile などのクライアント アプリケーションに対して、ユーザーのホーム プール、ダイヤルイン会議に参加するための URL など、重要なリソースを見つけるための手段を提供するものです。
構文
Get-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAutodiscoverConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
クライアント アプリケーションで Microsoft Lync Server 2010 を最大限に利用するためには、該当のアプリケーションが主要な Lync Server 2010 コンポーネントの場所を理解している必要があります。たとえば、認証済みユーザーは、ホーム プールを見つけることができる必要があります。なぜなら、そのホーム プールによってのみユーザーは認証を受けられるからです。同様に、認証されていないユーザーは、電話会議に参加するときに使用する URL の検索といった操作を実行できる必要があります。
すべてのユーザーが組織のファイアウォールの背後からログオンしている場合、これらの場所を見つけることは比較的簡単な作業です。しかし、ユーザーが Microsoft Lync Mobile または Lync Web Access を使用して外部の場所からシステムにアクセスし出すと、この比較的簡単な作業はどんどん複雑になります。
これは、分割ドメインのシナリオの場合、特に当てはまります。このシナリオでは、社内バージョンの Lync Server にアカウントを持つユーザーと、Microsoft Office 365 にアカウントを持つユーザーが社内に混在しています。このような状況では、ユーザー アカウントが異なる Active Directory フォレストに存在する可能性があります。これが、問題を引き起こすことがあります。たとえば、米国を拠点とするユーザーがヨーロッパからログオンする場合、システムはユーザーのフォレストを認識した上で、ログオン要求を正しいプールに向かわせることができる必要があります。
これらの問題を解決するために、2011 年 11 月リリースの Lync Server に自動検出サービスが導入されました。クライアント アプリケーションが Lync Server へのアクセスを試みると、自動検出サービスがクライアントの SIP アドレスを解析し、その要求を適切なプールにリダイレクトします。クライアント アプリケーションは、HTTP 要求を自動検出 URL に送信することによって自動検出サービスに接続します。これらの URL は、自動検出サービスが動作するように管理者が構成する必要があります (管理者は、URL の構成に加えて、その URL に対応する DNS レコードを作成する必要もあります)。
自動検出 URL は、自動検出構成設定に割り当てられます。これらの設定を、グローバル スコープまたはサイト スコープに適用できます。Get-CsAutoDiscoverConfiguration コマンドレットは、組織で現在使用されている自動検出設定 (および自動検出 URL) に関する情報を戻す手段を提供します。
このコマンドレットを実行できるユーザー: 既定では、Get-CsAutoDiscoverConfiguration コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XDS Identity |
取得する自動検出構成設定のコレクションの一意の識別子。グローバル設定を取得するには、次の構文を使用します。 -Identity "global" サイト スコープで構成された設定を取得するには、次のような構文を使用します。 -Identity "site:Redmond" このパラメーターが指定されていない場合、Get-CsAutoDiscoverConfiguration は組織で現在使用されているすべての自動検出構成設定を戻します。 |
Filter |
省略可能 |
文字列 |
戻す自動検出構成設定の ID を指定するときに、ワイルドカードを使用できます。たとえば、次の構文は、サイト スコープで構成されているすべての設定を戻します。 -Filter "site:*" Identity パラメーターと Filter パラメーターは、同じコマンドで同時に使用できないことに注意してください。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
中央管理ストア自体からではなく、中央管理ストアのローカル レプリカから自動検出構成データを取得します。 |
入力の種類
Get-CsAutoDiscoverConfiguration は、パイプライン入力を受け入れません。
戻り値の種類
Get-CsAutoDiscoverConfiguration は、Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration オブジェクトのインスタンスを戻します。
例
-------------------------- 例 1 --------------------------
Get-CsAutoDiscoverConfiguration
例 1 のコマンドでは、組織で現在使用されているすべての自動検出構成設定を戻します。
-------------------------- 例 2 --------------------------
Get-CsAutoDiscoverConfiguration -Identity "global"
例 2 では、自動検出構成設定の 1 つのコレクション (グローバル コレクション) のみが戻されます。
-------------------------- 例 3 --------------------------
Get-CsAutoDiscoverConfiguration -Filter "site:*"
上記のコマンドでは、サイト スコープに割り当てられているすべての自動検出構成設定を戻します。これを実行するには、Filter パラメーターとフィルター値 "site:*" を指定します。このフィルター値によって、文字列値 "site:" で始まる ID を持つ設定のみが戻されます。既定では、"site:" で始まる ID を持つ設定はすべて、サイト スコープで構成された設定です。
-------------------------- 例 4 --------------------------
Get-CsAutoDiscoverConfiguration | Where-Object {$_.WebLinks -like "*fabrikam.com"}
例 4 のコマンドでは、fabrikam.com という自動検出 URL が含まれるすべての自動検出構成設定を戻します。これを実行するには、最初に Get-CsAutoDiscoverConfiguration を使用して、組織で現在使用されているすべての自動検出設定のコレクションを戻します。このコレクションが Where-Object コマンドレットにパイプ処理され、WebLinks プロパティに文字列値 "fabrikam.com" を含む設定のみが選択されます。