New-CsHostingProvider
トピックの最終更新日: 2012-03-26
組織で使用する新しいホスティング プロバイダーを作成します。ホスティング プロバイダーは、フェデレーションを行う予定のドメインに対してインスタント メッセージング、プレゼンス、および関連するサービスを提供する、民間のサードパーティ組織です。Microsoft Lync Online 2010 などのホスティング プロバイダーは、公開プロバイダー (Yahoo!、MSN、AOL など) とは異なり、不特定多数に対してサービスを提供することはありません。
構文
New-CsHostingProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -ProxyFqdn <String> [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
New-CsHostingProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -EnabledSharedAddressSpace <$true | $false> -HostsOCSUsers <$true | $false> -ProxyFqdn <String> [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
解説
フェデレーションは、2 つの組織が組織間のコミュニケーションを促進する信頼関係を設定できるようにするための手段です。フェデレーションが確立されると、2 つの組織のユーザーはインスタント メッセージの送受信やプレゼンス通知の登録を行うことができ、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 のローカル実装によってホストされる) アカウントを持ちます。サードパーティのホスティング プロバイダーにより、アカウントが社外で保持されるユーザーもいます。ホスティング プロバイダーとフェデレーションを行うと、社内ユーザーと社外ユーザーが相互に通信できるようになります。
サードパーティのホスティング プロバイダーとフェデレーションを行うためには、新しいホスティング プロバイダーを作成して有効にする必要があります(また、サードパーティのプロバイダー側でもユーザーとのフェデレーション関係を作成する必要があります)。New-CsHostingProvider コマンドレットを使用すると、次の 3 種類のホスティング プロバイダー関係を設定できます。
ホスティング プロバイダーとの直接的なフェデレーション。このような関係を作成するには、Identity、ProxyFqdn、および Enabled の 3 つの必須パラメーターを指定する必要があります。
Lync Server サービスがホストされている分割ドメイン。このような関係を作成するには、3 つの必須パラメーターを指定する必要があります。また、EnabledSharedAddressSpace および HostsOCSUsers プロパティの両方を True に設定する必要があります。
Lync Server 以外のサービス (Microsoft Exchange など) がホストされている分割ドメイン。このような関係を作成するには、3 つの必須パラメーターを指定する必要があります。また、EnabledSharedAddressSpace を True に、HostsOCSUsers を False に設定する必要があります。
新しいホスティング プロバイダーを作成する場合は、そのプロバイダーの Identity とプロキシの完全修飾ドメイン名 (FQDN) の両方を一意にする必要があります。Identity またはプロキシ FQDN を共有する 2 つのホスティング プロバイダー (または 1 つのホスティング プロバイダーと 1 つの公開プロバイダーの場合でも) を持つことはできません。
また、ドメイン ネーム システム (DNS) サーバーのルーティングではなく、既定のルーティングを使用するように エッジ サーバーを構成している場合は、ホスティング プロバイダーとフェデレーションできません。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが New-CsHostingProvider コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsHostingProvider"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
文字列 |
作成するホスティング プロバイダーの一意の識別子。Identity は文字列値です。Identity は、ホスティング プロバイダーの FQDN (たとえば、fabrikam.com) や、サービスを提供する企業の名前 (Fabrikam, Inc.) にすることができます。 ホスティング プロバイダーの Identity は一意である必要があります。既存のプロバイダーと同じ Identity で新しいホスティング プロバイダーを作成しようとすると、コマンドは失敗します。 |
Enabled |
必須 |
ブール値 |
ドメインとホスティング プロバイダー間のネットワーク接続が有効になっているかどうかを示します。この値を True に設定しないと、2 つの組織間でメッセージを交換することはできません既定値は False です。 |
ProxyFqdn |
必須 |
FQNDN |
ホスティング プロバイダーによって使用されるプロキシ サーバーの FQDN です。この値は変更できない点に留意してください。ホスティング プロバイダーのプロキシ サーバーを後で変更した場合や、最初にプロキシの FQDN を指定するときに誤りがあった場合、そのプロバイダーのエントリを削除して再作成する必要があります。 |
AutoDiscoverUrl |
省略可能 |
文字列 |
Lync Server アカウントをホストするホスティング プロバイダーが使用する自動検出サービスの URL。自動検出サービスにより、Microsoft Lync Mobile のようなクライアント アプリケーションは、ユーザーのホーム プールのようなリソースにどうアクセスするかを判定できます。 |
EnabledSharedAddressSpace |
省略可能 |
ブール値 |
True の場合、ホスティング プロバイダーが分割ドメイン シナリオで使用されていることを示します。既定値は False です。 |
HostsOCSUsers |
省略可能 |
ブール値 |
True の場合、ホスティング プロバイダーが Lync Server アカウントをホストするために使用されていることを示します。False の場合、プロバイダーが Microsoft Exchange アカウントなど、他の種類のアカウントをホストしていることを示します。既定値は False です。 |
IsLocal |
省略可能 |
ブール値 |
True の場合、ホスティング プロバイダーによって使用されるプロキシ サーバーが Lync Server トポロジ内にあることを示します。既定値は False です。 |
VerificationLevel |
省略可能 |
文字列 |
ホスティング プロバイダーとのメッセージ送受信に対して許可された確認レベルを示します。VerificationLevel は、以下に示すいずれかの値に設定されます。 AlwaysVerifiable。ホスティング プロバイダーから送信されたすべてのメッセージが確認可能とみなされることを示します。つまり、ホスティング プロバイダーからのメッセージはすべて許可されます。 AlwaysUnverifiable。ホスティング プロバイダーから送信されたすべてのメッセージが確認不能とみなされることを示します。そのため、ホスティング プロバイダー上のユーザーも連絡先リストにある場合にのみ、メッセージが許可されます。 UseSourceVerification。ホスティング プロバイダーから送信されたメッセージに含まれる確認レベルを信頼します。このレベルが指定されていないと、メッセージは確認不能として拒否されます。 既定値は AlwaysVerifiable です。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
InMemory |
省略可能 |
スイッチ パラメーター |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。New-CsHostingProvider は、パイプライン処理された入力を受け入れません。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider オブジェクトの新しいインスタンスを作成します。
例
-------------------------- 例 1 ------------------------
New-CsHostingProvider -Identity Fabrikam.com -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True
例 1 では、Identity が Fabrikam.com の新しいホスティング プロバイダーを作成します。Identity の指定に加え、コマンドには他の 2 つの必須パラメーター、ProxyFqdn (Fabrikam.com によって使用されるプロキシ サーバーを指定) および Enabled (新しいホスティング プロバイダーが使用可能になっているかどうかを示す) も含めます。必須パラメーターのいずれかを省略すると、New-CsHostingProvider により、それらの値を入力してから処理を続行するように指示されます。
-------------------------- 例 2 ------------------------
New-CsHostingProvider -Identity Fabrikam.com -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -HostsOCSUsers $True -EnabledSharedAddressSpace $True
例 2 では、分割ドメイン シナリオで使用するための新しいホスティング プロバイダーの作成方法を示します(分割ドメインとは、Lync Server アカウントの一部が社内で保持され、他のアカウントがホスティング プロバイダーによって保持されていることを意味します)。このようなホスティング プロバイダーを作成するには、3 つの必須パラメーター (Identity、ProxyFqdn、および Enabled) を指定する必要があります。また、HostsOCSUsers と EnabledSharedAddressSpace の両方のパラメーターを含めて、True に設定する必要があります。Lync Server 以外のサービス (Microsoft Exchange など) をホストする分割ドメイン プロバイダーを作成するには、これらと同じ 2 つのパラメーターを含める必要がありますが、HostsOCSUsers は False に設定します。