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