Remove-CsPublicProvider
トピックの最終更新日: 2012-03-26
組織で使用するように構成した公開プロバイダーを削除します。公開プロバイダーとは、インスタント メッセージ (IM)、プレゼンス、および関連サービスを、一般公衆に対して提供する組織のことです。Microsoft Lync Server 2010 には、次の 3 つの構成済みの公開プロバイダーが付属していますが、無効になっています。Yahoo!、AOL、および MSN。
構文
Remove-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
フェデレーションは、2 つの組織が組織間のコミュニケーションを促進する信頼関係を設定できるようにするための手段です。フェデレーションが確立されると、2 つの組織のユーザーはインスタント メッセージの送受信やプレゼンス通知の登録ができ、Microsoft Lync 2010 のような SIP アプリケーションを使用して互いにその他の通信をすることもできます。Lync Server 2010 では、次の 3 種類のフェデレーションが可能です。1) 自組織と他組織間の直接フェデレーション、2) 自組織と公開プロバイダー間のフェデレーション、3) 自組織とサードパーティ ホスティング プロバイダー間のフェデレーション。
公開プロバイダーとは、一般公衆向けの SIP 通信サービスを提供する組織のことです。公開プロバイダーとフェデレーション関係を確立すると、そのプロバイダーがホストするアカウントを持つすべてのユーザーと、効率よくフェデレーションを確立できます。たとえば、MSN とフェデレーションを確立すると、自組織のユーザーが、MSN のインスタント メッセージ アカウントを持つすべてのユーザーと、インスタント メッセージやプレゼンス情報を交換できるようになります。
公開プロバイダーとフェデレーションを行うためには、新しい公開プロバイダーを作成して有効にする必要があります (また、公開プロバイダー側でもフェデレーション関係を作成する必要があります)。後でこの関係を終了する場合は、Remove-CsPublicProvider コマンドレットを使用してその公開プロバイダーを削除できます。公開プロバイダーを削除すると、そのプロバイダーがフェデレーション パートナーのリストから削除されます。その時点で、関係を再確立する唯一の方法は、そのプロバイダーを再作成することです。関係を一時的に中断する場合は、代わりに Disable-CsPublicProvider コマンドレットを使用します。公開プロバイダーを無効にしても、そのプロバイダーはフェデレーション パートナーのリストからは削除されません。代わりに、そのプロバイダーを無効とするマークが付けられ、自組織とそのプロバイダー間の通信が中断されるだけです。関係を再確立するために、Enable-CsPublicProvider を使用してプロバイダーを再度有効にできます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Remove-CsPublicProvider コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPublicProvider"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
文字列 |
削除する公開プロバイダーの一意の識別子。Identity は通常、サービスを提供する Web サイトの名前 (Yahoo!、AOL、MSN など) です。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider オブジェクト。Remove-CsPublicProvider は、公開プロバイダー オブジェクトのパイプライン処理されたインスタンスを受け入れます。
戻り値の種類
なし。代わりに、Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider オブジェクトのインスタンスを削除します。
例
-------------------------- 例 1 ------------------------
Remove-CsPublicProvider -Identity "MSN"
上のコマンドを実行すると、Identity が MSN の公開プロバイダーが削除されます。このコマンドの完了後、MSN は構成済み公開プロバイダーのリストに表示されなくなります。その時点で、MSN とのフェデレーションを再確立する唯一の方法は、このプロバイダーを再作成することです。
-------------------------- 例 2 ------------------------
Get-CsPublicProvider | Remove-CsPublicProvider
例 2 を実行すると、組織で使用するように構成されているすべての公開プロバイダーが削除されます。これを実行するには、まず、このコマンドでは Get-CsPublicProvider を使用して、使用するために現在構成されているすべての公開プロバイダーのコレクションを取得します。次に、このコレクションを Remove-CsPublicProvider にパイプ処理し、これにより、コレクション内の各プロバイダーを削除します。
-------------------------- 例 3 ------------------------
Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False} | Remove-CsPublicProvider
例 3 を実行すると、現在無効にされているすべての公開プロバイダーが、構成済み公開プロバイダーのセットから削除されます。このタスクを実行するために、このコマンドでは最初に Get-CsPublicProvider を使用して、使用するために現在構成されたすべての公開プロバイダーのコレクションを取得しています。このコレクションを Where-Object コマンドレットにパイプ処理し、Enabled プロパティが False に等しいプロバイダーだけを選択しています。次に、このフィルター処理済みのコレクションを Remove-CsPublicProvider にパイプ処理し、コレクション内のすべての項目を削除しています。