Disable-CsHostingProvider
トピックの最終更新日: 2012-03-23
現在組織で使用しているホスティング プロバイダーを無効にします。ホスティング プロバイダーは、フェデレーションを行う予定のドメインに対してインスタント メッセージング、プレゼンス、および関連するサービスを提供するサードパーティ組織です。Microsoft Lync Online 2010 などのホスティング プロバイダーは、公開プロバイダー (Yahoo!、MSN、AOL など) とは異なり、不特定多数に対してサービスを提供することはありません。
構文
Disable-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Disable-CsHostingProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
解説
フェデレーションは、2 つの組織が組織間のコミュニケーションを促進する信頼関係を設定できるようにするための手段です。フェデレーションが確立されると、2 つの組織のユーザーはインスタント メッセージの送受信やプレゼンス通知の登録を行うことができ、Microsoft Lync 2010 のような SIP アプリケーションを使用して互いに通信することもできます。Microsoft Lync Server 2010 では、次の 3 種類のフェデレーションが可能です。1) 自組織と他組織間の直接フェデレーション、2) 自組織と公開プロバイダー間のフェデレーション、3) 自組織とサードパーティ ホスティング プロバイダー間のフェデレーション。
ホスティング プロバイダーは、他の組織に対して SIP 通信サービスを提供する組織です。たとえば、Fabrikam, Inc. では、Contoso、Northwind Traders、および Wingtip Toys のユーザーをホストしています。ホスティング プロバイダーとのフェデレーション関係を確立すると、そのプロバイダーがホストしている組織と効率的にフェデレーションを確立することができます。たとえば、Fabrikam とフェデレーションを行うと、ユーザーは、Contoso、Northwind Traders、および Wingtip Toys のユーザーとインスタント メッセージやプレゼンス情報を交換できるようになります。
ホスティング プロバイダーは、分割ドメインのシナリオでも使用されます。分割ドメイン シナリオの場合、 一部の Lync Server 2010 ユーザーのアカウントは社内 (つまり、ローカルの Lync Server 実装上でホストされています) でホストされています。サードパーティのホスティング プロバイダーにより、アカウントが社外で保持されるユーザーもいます。ホスティング プロバイダーとフェデレーションを行うと、社内ユーザーと社外ユーザーが相互に通信できるようになります。
サードパーティのホスティング プロバイダーとフェデレーションを行うためには、新しいホスティング プロバイダーを作成して有効にする必要があります(また、サードパーティのプロバイダー側でもユーザーとのフェデレーション関係を作成する必要があります)。ホスティング プロバイダーは、そのプロバイダーの作成時に有効にできます。または、Enable-CsHostingProvider コマンドレットを使用して、作成後に有効にすることもできます。また、Disable-CsHostingProvider コマンドレットを使用して、関係をいつでも無効にすることができます。ホスティング プロバイダーを無効にしても、そのプロバイダーは有効なフェデレーション パートナーのままでいます。ただし、組織とそのプロバイダー間のすべての通信アクティビティは、プロバイダーが再度有効にされるまで中断されます。
ドメイン ネーム システム (DNS) サーバーのルーティングではなく、既定のルーティングを使用するようにエッジ サーバーを構成している場合、ホスティング プロバイダーとのフェデレーションを行うことはできません。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Disable-CsHostingProvider コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Disable-CsHostingProvider"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
文字列 |
無効にするホスティング プロバイダーの一意の識別子。Identity は、ホスティング プロバイダーの完全修飾ドメイン名 (FQDN) (たとえば、fabrikam.com) か、あるいはサービスを提供する企業の名前 (Fabrikam, Inc.) にすることができます。 |
Instance |
省略可能 |
DisplayHostingProvider オブジェクト |
個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider オブジェクト。Disable-CsHostingProvider は、パイプライン処理されたホスティング プロバイダー オブジェクトのインスタンスを受け入れます。
戻り値の種類
なし。代わりに、このコマンドレットは、Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider オブジェクトのインスタンスを無効にします。
例
-------------------------- 例 1 ------------------------
Disable-CsHostingProvider -Identity "Fabrikam.com"
例 1 に示すコマンドは、ホスティング プロバイダー Fabrikam.com を無効にします。Fabrikam.com が既に無効にされている場合は、エラー メッセージを戻します。
-------------------------- 例 2 ------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True} | Disable-CsHostingProvider
上記のコマンドでは、現在有効になっているホスティング プロバイダーをすべて無効にします。このタスクを実行するには、まず Get-CsHostingProvider を呼び出して、組織内で使用するように構成されたすべてのホスティング プロバイダーのコレクションを戻します。その後、コレクションを Where-Object コマンドレットにパイプ処理して、Enabled プロパティが True と等しいプロバイダーのみを選択します。フィルター処理されたコレクションは Disable-CsHostingProvider にパイプ処理され、その結果、コレクション内の各プロバイダーが無効にされます。
-------------------------- 例 3 ------------------------
Get-CsHostingProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable" -and $_.Enabled -eq $True} | Disable-CsHostingProvider
例 3 では、確認レベルが AlwaysVerifiable と等しくない、有効にされているホスティング プロバイダーをすべて無効にします。このタスクを実行するには、まず、Get-CsHostingProvider を使用して、組織内で使用するように構成されたすべてのホスティング プロバイダーのコレクションを戻します。このコレクションは Where-Object コマンドレットにパイプ処理され、次の 2 つの基準を満たすプロバイダーのみが選択されます。1) VerificationLevel プロパティが AlwaysVerifiable と等しくなく、および 2) Enabled プロパティが True と等しい。フィルター処理されたコレクションは Disable-CsHostingProvider にパイプ処理され、その結果、コレクション内の各プロバイダーが無効にされます。