次の方法で共有


Grant-CsClientVersionPolicy

 

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

クライアント バージョン ポリシーをグローバル スコープ、サイト スコープ、サービス スコープ、またはユーザーごとのスコープに割り当てます。クライアント バージョン ポリシーを使用すると、Microsoft Lync Server 2010 システムにログオンできるクライアント (Microsoft Office Communicator 2007 R2 など) を指定できます。

構文

Grant-CsClientVersionPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

解説

クライアント バージョン ポリシーは、クライアント バージョン ルールのコレクションを表しており、クライアント バージョン ルールは Lync Server 2010 にログオンできるクライアント アプリケーションを決定するのに使用されます。ユーザーが Lync Server 2010 へのログオンを試みると、そのユーザーのクライアント アプリケーションは SIP ヘッダーをサーバーに送信します。このヘッダーには、ソフトウェアのメジャー バージョン、マイナー バージョン、およびビルド番号などのアプリケーション自体に関する詳細情報が含まれます。SIP ヘッダーに含まれるバージョン情報は、次にクライアント バージョン ルールのコレクションと照合され、ルールが特定のアプリケーションに適用されるかどうかが確認されます。このようなルールが存在する場合、次に Lync Server 2010 はルールで特定された処理を実行します。たとえば、ルールにより、Lync Server 2010 に対してログオンの許可、ログオンの禁止、またはログオンは許可してから確認なしにクライアント アプリケーションを最新バージョンに更新すること (たとえば、Office Communicator 2007 R2 を Microsoft Lync 2010 に更新するなど) を指示できます。

クライアント バージョン ポリシーは、グローバル スコープ、サイト スコープ、サービス スコープ (レジストラー サービスのみ)、またはユーザーごとのスコープで適用することができます。このポリシーにより、システムにアクセスするときに使用できるクライアント アプリケーションを柔軟に決定することができます。たとえば、以前のクライアント アプリケーションでは Lync Server 2010 と同様の機能がサポートされないため、Communicator 2007 R2 を使用した Lync 2010 へのログオンをユーザーに禁止することがあります。ただし、ハードウェアまたはソフトウェアの競合のため、Lync 2010 にアップグレードできないユーザーの選択グループがある場合もあります。その場合、個別のルール、および個別のクライアント バージョン ポリシーを作成して、そのようなユーザーに Communicator 2007 R2 からのログオンを許可できます。

Grant-CsClientVersionPolicy コマンドレットを使用すると、クライアント バージョン ポリシーを個々のユーザーに割り当てることができます。ユーザーごとのポリシーを作成した場合、そのポリシーが自動的にいずれかのユーザーに割り当てられることはありません。Grant-CsClientVersionPolicy を呼び出して、ポリシーをユーザーまたはユーザーのセットに明示的に割り当てるまで、割り当ては行われません。

重要なのは、クライアント バージョン ポリシーをフェデレーション ユーザーに適用するのではなく、組織の中で使用されるクライアント バージョン ポリシーによってフェデレーション ユーザーがバインドされることです。たとえば、あるフェデレーション ユーザーがクライアント A を使用し、そのクライアントがフェデレーション組織によって許可されているとします。フェデレーション組織がクライアント A の使用を許可している限り、このユーザーはそのクライアントを使用して組織と通信できます。クライアント バージョン ポリシーでクライアント A の使用を禁止していても、このことは可能です。組織に適用されるクライアント バージョン ポリシーが、フェデレーション組織で使用されるクライアント バージョン ポリシーより優先されることはありません。

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsClientVersionPolicy"}

パラメーター

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

Identity

必須

ユーザー ID パラメーター

ポリシーを割り当てる必要のあるユーザー アカウントの Identity を示します。ユーザーの Identity は、以下の 4 つの形式のうちの 1 つを使用して指定できます。1) ユーザーの SIP アドレス、2) ユーザーのユーザー プリンシパル名 (UPN)、3) ドメイン\ログオン形式 (litwareinc\kenmyer など) のユーザーのドメイン名とログオン名、および 4) ユーザーの Active Directory 表示名 (Ken Myer など)。ユーザーの Active Directory 識別名を使用してユーザーの Identity を参照することもできます。

また、表示名をユーザーの Identity として使用する場合は、アスタリスク (*) ワイルドカード文字を使用できます。たとえば、"* Smith" という Identity は、末尾が " Smith" という文字列値の表示名を持つすべてのユーザーを戻します。

PolicyName

必須

文字列

割り当てられるポリシーの "名前" です。PolicyName はポリシー スコープを持たないポリシー Identity ("tag:") にすぎません。たとえば、Identity が tag:Redmond のポリシーの PolicyName は Redmond です。Identity が tag:RedmondClientVersionPolicy のポリシーのPolicyName は RedmondClientVersionPolicy です。ユーザーに以前割り当てたユーザーごとのポリシーを割り当て解除するには、PolicyName に null 値 ($null) を設定します。

DomainController

省略可能

文字列

ポリシー割り当て時に接続するドメイン コントローラーを指定できるようにします。このパラメーターを指定しないと、このコマンドレットでは最初に使用可能なドメイン コントローラーが使用されます。

PassThru

省略可能

スイッチ パラメーター

指定すると、コマンドレットが Windows PowerShell パイプラインを介してユーザー オブジェクトを渡すようになります。既定では、Grant-CsClientVersionPolicy はパイプラインを介してオブジェクトを渡しません。

WhatIf

省略可能

スイッチ パラメーター

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

Confirm

省略可能

スイッチ パラメーター

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

入力の種類

文字列値または Microsoft.Rtc.Management.ADConnect.Schema.ADUser オブジェクト。Grant-CsClientVersionPolicy は、ユーザー アカウント ID を表す文字列値のパイプライン処理された入力を受け入れます。このコマンドレットはユーザー オブジェクトのパイプライン処理された入力も受け入れます。

戻り値の種類

既定では、Grant-CsClientVersionPolicy は、値もオブジェクトも戻しません。ただし、PassThru パラメーターを指定した場合、このコマンドレットは Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact オブジェクトのインスタンスを戻します。

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

Grant-CsClientVersionPolicy -Identity "Ken Myer" -PolicyName "RedmondClientVersionPolicy"

例 1 では、RedmondClientVersionPolicy というクライアント バージョン ポリシーが Ken Myer というユーザーに割り当てられます。

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

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

例 2 に示すコマンド を実行すると、RedmondClientVersionPolicy というクライアント バージョン ポリシーが Redmond 市に勤務するユーザーすべてに割り当てられます。これを実行するには、このコマンドでは最初に LdapFilter パラメーターを指定して Get-CsUser を使用し、ユーザー アカウントの適切なコレクションを取得しています。フィルター値 "l=Redmond" ("l" は小文字の L で、"ローカリティ (locality)" という名前の LDAP 属性のこと) によって、取得されるデータが Redmond 市に勤務するユーザーに制限されています。次にこのコレクションを Grant-CsClientVersionPolicy にパイプ処理し、指定したポリシーをコレクション内の各ユーザーに割り当てています。

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

Get-CsUser -OU "ou=Redmond,ou=North America,dc=litwareinc,dc=com" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

例 3 では、特定の組織単位 (OU) 内のすべてのユーザーに RedmondClientVersionPolicy というクライアント バージョン ポリシーが割り当てられます。このタスクを実行するために、このコマンドでは最初に OU パラメーターを指定して Get-CsUser を呼び出しています。パラメーターの値は、自身のユーザーにクライアント バージョン ポリシーを割り当てる OU の識別名 (ou=Redmond,ou=North America,dc=litwareinc,dc=com) を表します。ユーザー アカウントを取得した後、コレクションを Grant-CsClientVersionPolicy にパイプ処理し、これらの各ユーザーに RedmondClientVersionPolicy を割り当てています。

-------------------------- 例 4 --------------------------

Get-CsUser -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

上のコマンドを実行すると、RedmondClientVersionPolicy というクライアント バージョン ポリシーが、以前 RedmondVoicePolicy という音声ポリシーが割り当てられていたすべてのユーザーに割り当てられます。これを実行するために、このコマンドでは最初に Filter パラメーターを指定して Get-CsUser を呼び出しています。フィルター値 {VoicePolicy -eq "RedmondVoicePolicy"} は、戻されるユーザー アカウントを、VoicePolicy プロパティが "RedmondVoicePolicy" と等しいユーザー アカウントに限定するものです。次に、フィルター処理されたユーザー アカウントを Grant-CsClientVersionPolicy にパイプ処理し、RedmondClientVersionPolicy というクライアント バージョン ポリシーを割り当てています。

-------------------------- 例 5 --------------------------

Get-CsUser | Grant-CsClientVersionPolicy -PolicyName $Null

例 5 では、組織内のすべてのユーザーから、以前に割り当てられたユーザーごとのクライアント バージョン ポリシーが割り当て解除されます。この処理を行うため、このコマンドでは最初に Get-CsUser を使用して、Lync Server が有効になっている組織内のすべてのユーザーのコレクションを戻しています。次にこのコレクションを Remove-CsClientVersionPolicy にパイプ処理し、これらのユーザーに割り当てられたユーザーごとのクライアント バージョン ポリシーをすべて削除しています。これは、PolicyName パラメーターの値を $null に設定することで行っています。