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