次の方法で共有

  • [アーティクル]

Set-CsClientVersionConfiguration

 

トピックの最終更新日: 2012-03-27

クライアント バージョン構成設定の指定したコレクションを変更します。クライアント バージョンの構成設定によって、システムにログオンする各クライアントのバージョン番号を Microsoft Lync Server 2010 が確認するかどうかが決定されます。クライアント バージョン フィルターが有効な場合、クライアント アプリケーションがシステムにアクセス可能かどうかは、該当するクライアント バージョン ポリシーに構成された設定に基づきます。

構文

Set-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionConfiguration [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

解説

Lync Server 2010 では、ユーザーがシステムにログオンする際に使用できるクライアント ソフトウェア、および (同じ程度重要な) そのソフトウェアのバージョン番号の指定に関して、管理者の裁量が非常に大きくなっています。たとえば、ユーザーに Microsoft Lync 2010 を使用して Lync Server 2010 にログオンすることを求める技術上の理由はありません。ユーザーが Microsoft Office Communicator 2007 R2 を使用してログオンできないという、技術上の制約はありません。

その一方で、ユーザーが Office Communicator 2007 R2 を使用してログオンしないようにする必要がある、技術上以外の理由がある場合があります。たとえば、Office Communicator 2007 R2 では Lync 2010 にある機能すべてはサポートされません。その結果、Office Communicator 2007 R2 を使用してログオンするユーザーは、Lync 2010 を使用してログオンするユーザーとは異なる環境を利用することになります。このため、ユーザーにとっても、多数の異なるクライアント アプリケーションをサポートするヘルプ デスク担当者にとっても対応することが難しくなります。

これが組織にとって問題となる可能性がある場合、クライアント バージョン フィルターを使用して、Lync Server 2010 へのログオンに使用できるクライアント アプリケーションを指定できます。Lync Server 2010 のインストール時、グローバルなクライアント バージョン構成設定のセットがインストールされて有効になります。これらの設定を使用して、クライアント バージョン フィルター処理を有効にするかどうかを決定します。このグローバル設定のほかに、クライアント バージョンの構成設定はサイト スコープでも適用できます。その場合は、サイト設定がグローバル設定よりも優先されます。

Set-CsClientVersionConfiguration コマンドレットを使用して、クライアント バージョン構成設定の既存のコレクションを変更できます。

クライアント バージョン構成がセキュリティ機能ではないという点に注意してください。このテクノロジはクライアント アプリケーションからの自己報告を信頼しています。アプリケーションが本当にそのアプリケーションであるかどうかの確認や、アプリケーションが申告したバージョン番号の検証を行おうとはしません。

このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Set-CsClientVersionConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientVersionConfiguration"}

パラメーター

パラメーター 必須かどうか 型 説明

Identity

省略可能

XdsIdentity

変更するクライアント バージョン構成設定の一意の識別子を表します。グローバル設定を変更するには、次のような構文を使用します。-Identity global。サイト スコープに割り当てられた設定を変更するには、次のような構文を使用します。"site:Redmond"。

このパラメーターが含まれない場合は、Set-CsClientVersionConfiguration がグローバル設定を自動的に構成します。

Instance

省略可能

ClientVersionPolicy オブジェクト

個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。

DefaultAction

省略可能

文字列

対象のクライアント バージョン ポリシー内に見つからないバージョン番号のクライアント アプリケーションから、ユーザーがログオンしようとした場合に、実行されるアクションを示します。DefaultAction は、以下に示すいずれかの値に設定されます。

Allow。クライアント アプリケーションのログオンを許可します。

AllowWithUrl。クライアント アプリケーションのログオンを許可します。また、承認されたクライアント アプリケーションをユーザーがダウンロードすることができる Web ページの URL が記載されたメッセージ ボックスが、ユーザーに対して表示されます。この Web ページの URL は、DefaultUrl プロパティの値として指定する必要があります。

Block。クライアント アプリケーションはログオンできません。

BlockWithUrl。クライアント アプリケーションはログオンできません。ただし、"アクセス拒否" のメッセージ ボックスをユーザーに表示します。このメッセージ ボックスには、承認されたクライアント アプリケーションをユーザーがダウンロードできる Web ページの URL が記載されています。この Web ページの URL は、DefaultUrl プロパティの値として指定する必要があります。

Enabled プロパティが False に設定されている場合、このプロパティは無視されます。Enabled プロパティが False に設定されている場合、クライアント バージョン フィルターは種類を問わず実行されません。

DefaultUrl

省略可能

文字列

承認されたクライアント アプリケーションをユーザーがダウンロードできる Web ページの URL を指定します。この URL が指定されており、DefaultAction が BlockWithURL に設定されている場合、サポートされていないクライアント アプリケーションからログオンしようとすると、この URL が "アクセスが拒否されました" メッセージ ボックスに表示されます。

Enabled

省略可能

ブール値

クライアント バージョン フィルター処理を有効にするか無効にするかを指定します。Enabled プロパティが True の場合、ログオンしようとしている各クライアント アプリケーションのバージョン番号がサーバーでチェックされ、該当するクライアント バージョン ポリシーに基づいてアクセスが許可または拒否されます。Enabled プロパティが False の場合、ログオン機能を備えたすべてのクライアント アプリケーションのログオンを許可します。

Force

省略可能

スイッチ パラメーター

コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。

WhatIf

省略可能

スイッチ パラメーター

実際にコマンドを実行せずに、コマンドの実行結果がわかります。

Confirm

省略可能

ブール値

コマンドの実行前に確認メッセージを表示します。

入力の種類

Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration オブジェクト。Set-CsClientVersionConfiguration は、パイプライン処理されたクライアント バージョン構成オブジェクトのインスタンスを受け入れます。

戻り値の種類

Set-CsClientVersionConfiguration は、値またはオブジェクトを戻しません。代わりに、Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration オブジェクトのインスタンスを構成します。

例

-------------------------- 例 1 --------------------------

Set-CsClientVersionConfiguration -Identity site:Redmond -Enabled $False

例 1 では、Set-CsClientVersionConfiguration を使用して、Identity が "site:Redmond" の設定コレクションを変更します。この場合、クライアント バージョン構成設定を無効にするため、Enabled パラメーターを False に設定しています。

-------------------------- 例 2 --------------------------

Get-CsClientVersionConfiguration | Set-CsClientVersionConfiguration -DefaultURL "https://litwareinc.com/csclients"

上記の例では、組織内で現在使用中のすべてのクライアント バージョン構成設定の DefaultUrl プロパティが変更されます。これを実行するには、まずコマンドで、追加パラメーターを指定せずに Get-CsClientVersionConfiguration を呼び出し、すべてのクライアント バージョン構成設定を戻します。その情報を Set-CsClientVersionConfiguration にパイプ処理します。その結果、各構成コレクションの DefaultUrl 値が https://litwareinc.com/csclients に設定されます。

-------------------------- 例 3 --------------------------

Get-CsClientVersionConfiguration | Where-Object {$_.DefaultAction -eq "Block"} | Set-CsClientVersionConfiguration -DefaultAction "BlockWithUrl" -DefaultURL "https://litwareinc.com/csclients"

例 3 では、DefaultAction が現在 Block に設定されているクライアント バージョン構成設定をすべて変更します。このタスクを実行するため、まず Get-CsClientVersionConfiguration を使用して、現在使用されているすべてのクライアント バージョン構成設定を戻しています。その情報は Where-Object コマンドレットにパイプ処理され、DefaultAction プロパティが "Block" と等しい項目のみを選択します。次に、フィルター処理されたコレクションを Set-CsClientVersionConfiguration にパイプ処理し、コレクション内の各項目に対して次の 2 つの処理を行います。1) DefaultAction を BlockWithUrl に設定し、2) DefaultUrl を https://litwareinc.com/csclients に設定します。