Remove-CsAutodiscoverConfiguration
トピックの最終更新日: 2012-04-23
自動検出構成設定のコレクションを削除します。自動検出サービスを使用すると、Lync Web Access や Microsoft Lync Mobile などのクライアント アプリケーションで、ユーザーのホーム プールや、ダイヤルイン会議に参加するための URL など、主要なリソースを見つけられるようになります。
構文
Remove-CsAutodiscoverConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 は、自動検出構成設定に割り当てられます。これらの設定を、グローバル スコープまたはサイト スコープに適用できます。サイト スコープに割り当てられた設定を後から削除する場合は、Remove-CsAutoDiscoverConfiguration コマンドレットを実行します。このコマンドレットは、グローバル設定に対しても実行できます。ただし、その場合はグローバル設定は削除されません。代わりに、グローバル コレクションに割り当てられた自動検出 URL が削除されます。
このコマンドレットを実行できるユーザー: 既定では、Remove-CsAutoDiscoverConfiguration コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XDS Identity |
削除する自動検出設定を表す一意の識別子。自動検出設定は、グローバル スコープまたはサイト スコープで構成できます。グローバル ポリシーを "削除" するには、次の構文を使用します: -Identity global。(グローバル設定を実際に削除することはできません。代わりに、グローバル設定のすべてのプロパティが既定値にリセットされます)。 サイト スコープで構成されている設定を削除するには、次のような構文を使用します。 -Identity "site:Redmond" Identity 指定時はワイルドカードを使用できないことに注意してください。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
入力の種類
Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration オブジェクト。Remove-CsAutoDiscoverConfiguration は、AutoDiscoverConfiguration オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
なし。代わりに、このコマンドレットは、Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration オブジェクトのインスタンスを削除します。
例
-------------------------- 例 1 --------------------------
Remove-CsAutoDiscoverConfiguration -Identity "site:Redmond"
例 1 に示すコマンドを実行すると、Redmond サイト用の自動検出構成設定が削除されます。
-------------------------- 例 2 --------------------------
Get-CsAutoDiscoverConfiguration -Filter "site:*" | Remove-CsAutoDiscoverConfiguration
例 2 では、サイト スコープに割り当てられたすべての自動検出構成設定が削除されます。これを行うために、コマンドでは最初に Get-CsAutoDiscoverConfiguration コマンドレットと Filter パラメーターを使用して、構成設定のコレクションを戻しています。フィルター値 "site:*" を指定することで、文字列値 "site:" で始まる識別子を持つ設定だけが戻されるようにしています。フィルター処理されたコレクションがパイプを通じて Remove-CsAutoDiscoverConfiguration に渡され、ここでコレクションの各アイテムが削除されます。