Enable-CsHostingProvider
トピックの最終更新日: 2012-03-23
組織で使用するために、ホスティング プロバイダーを有効にします。ホスティング プロバイダーは、フェデレーションを行う予定のドメインに対してインスタント メッセージング、プレゼンス、および関連するサービスを提供する、サードパーティ組織です。Microsoft Lync Online 2010 などのホスティング プロバイダーは、公開プロバイダー (Yahoo!、MSN、AOL など) とは異なり、不特定多数に対してサービスを提供することはありません。
構文
Enable-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Enable-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 コマンドレットを使用して、事後にそのプロバイダーを有効にすることもできます。
ドメイン ネーム システム (DNS) サーバーのルーティングではなく、既定のルーティングを使用するようにエッジ サーバーを構成している場合、ホスティング プロバイダーとのフェデレーションを行うことはできません。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Enable-CsHostingProvider コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Enable-CsHostingProvider"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
文字列 |
有効にするホスティング プロバイダーの一意の識別子。Identity はホスティング プロバイダーの完全修飾ドメイン名 (FQDN) (fabrikam.com など) や、サービスを提供する企業の名前 (Fabrikam, Inc.) にすることができます。 |
Instance |
省略可能 |
DisplayHostingProvider オブジェクト |
個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider オブジェクト。Enable-CsHostingProvider はホスティング プロバイダー オブジェクトのパイプライン処理されたインスタンスを受け入れます。
戻り値の種類
なし。代わりに Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider オブジェクトのインスタンスを有効にします。
例
-------------------------- 例 1 ------------------------
Enable-CsHostingProvider -Identity Fabrikam.com
例 1 では、Fabrikam.com という Identity を持つホスティング プロバイダーを有効にして使用できるようにします。Fabrikam.com が既に有効になっており使用できる場合、このコマンドによってエラーが戻されます。
-------------------------- 例 2 ------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $False} | Enable-CsHostingProvider
例 2 では、現在無効になっているすべてのホスティング プロバイダーを有効にする方法を示しています。これを実行するには、組織内で使用するために現在構成されている、すべてのホスティング プロバイダーのコレクションが戻されるよう、コマンドでまず、Get-CsHostingProvider を追加パラメーターなしで呼び出します。このコレクションが Where-Object コマンドレットにパイプ処理され、Enabled プロパティが False と等しいすべてのプロバイダーが取得されます。定義上、これは現在無効になっているすべてのプロバイダーです。このフィルター処理されたコレクションが Enable-CsHostingProvider にパイプ処理され、コレクション内の各プロバイダーが有効になります。
-------------------------- 例 3 ------------------------
Get-CsHostingProvider | Where-Object {$_.EnabledSharedAddressSpace -eq $True -and $_.Enabled -eq $False} | Enable-CsHostingProvider
例 3 では、"分割ドメイン" で使用するすべてのホスティング プロバイダーのセットアップを有効にして使用できるようにします(分割ドメインとは、Lync Server アカウントの一部が社内で保持され、他のアカウントがホスティング プロバイダーによって保持されていることを意味します)。このタスクを実行するため、コマンドではまず Get-CsHostingProvider を呼び出して、現在構成されているすべてのホスティング プロバイダーから成るコレクションを戻します。次に、このコレクションが Where-Object コマンドレットにパイプ処理されます。このコマンドレットでは、次の 2 つの条件を満たすプロバイダーのみを選択します。1) EnabledSharedAddressSpace プロパティが True と等しい、および 2) Enabled プロパティが False と等しい。その後、フィルター処理されたコレクションが Enable-CsHostingProvider にパイプ処理され、コレクション内の各プロバイダーが有効になります。