Get-CsDeviceUpdateRule
トピックの最終更新日: 2012-03-23
組織での使用向けに構成されているデバイス更新ルールに関する情報を戻します。デバイス更新ルールを使用して、ファームウェア更新プログラムを、Microsoft Lync 2010 Phone Edition を実行するデバイスに関連付けます。
構文
Get-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDeviceUpdateRule [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
Microsoft Lync Server 2010 では、Lync 2010 Phone Edition を実行するデバイスにファームウェア更新プログラムを提供する方法として、デバイス更新ルールを使用します。管理者は Lync Server 2010 にデバイス更新ルールを定期的にアップロードします。それらのルールのテストと承認後、適切なデバイスがシステムに接続した際に自動的にダウンロードされて適用されます。既定では、デバイスは、電源が入って Lync Server に接続するたびに新しい更新ルールがあるかどうか確認します。また、最初のサインオン以降は、24 時間ごとに更新プログラムがあるかどうか確認します。
デバイス更新ルールは Web サービス サービスにインポート (および適用) することができます。Get-CsDeviceUpdateRule コマンドレットを使用すると、組織での使用向けにインポートされているデバイス更新ルールに関する情報を戻すことができます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsDeviceUpdateRule コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDeviceUpdateRule"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsIdentity |
デバイス更新ルールの一意の識別子。デバイス更新ルールの Identity は、次の 2 つの部分で構成されています。ルールが適用されているサービス スコープ (たとえば、service:WebServer:atl-cs-001.litwareinc.com) およびルールに割り当て済みのグローバル一意識別子 (GUID) (たとえば、d5ce3c10-2588-420a-82ac-dc2d9b1222ff9)。これに基づいて、このデバイス更新ルールの Identity は次のようになります。"service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 "。 Identity を指定するときには、ワイルドカードを使用することはできません。ルールを指定する際にワイルドカードを使用する場合は、Filter パラメーターを使用します。 |
Filter |
省略可能 |
文字列 |
1 つのデバイス更新ルールまたは一連のルールの Identity を指定する際に、ワイルドカードを使用できます。たとえば、WebServer:atl-cs-001.litwareinc.com のすべてのデバイス更新ルールを戻すには、次のフィルター値を使用します。"service:WebServer:atl-cs-001.litwareinc.com*"。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカからデバイス更新ルールを取得します。 |
入力の種類
なし。Get-CsDeviceUpdateRule はパイプライン処理された入力を受け入れません。
戻り値の種類
Get-CsDeviceUpdateRule を実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 ------------------------
Get-CsDeviceUpdateRule
上記のコマンドは、組織で適用されているすべてのデバイス更新ルールに関する情報を戻します。追加パラメーターを指定せずに Get-CsDeviceUpdateRule を呼び出すと、常にデバイス更新ルールの完全なコレクションが戻されます。
-------------------------- 例 2 ------------------------
Get-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9
例 2 のコマンドは、"WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9" という Identity を持つデバイス更新ルールに関する情報を戻します。
-------------------------- 例 3 ------------------------
Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com*
例 3 では、WebServer:atl-cs-001.litwareinc.com というサービスに構成されているすべてのデバイス更新ルールに関する情報を戻します。このタスクを実行するには、Filter パラメーターを使用してフィルター値 "WebServer:atl-cs-001.litwareinc.com *" を指定します。そのフィルターで、戻されるデータを先頭が "service:WebServer:atl-cs-001.litwareinc.com" という文字列の Identity を持つデバイス更新ルールに制限します。
-------------------------- 例 4 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"}
上記のコマンドは、Brand プロパティが "LG-Nortel" と等しいすべてのデバイス更新ルールを戻します。これを行うには、組織内のすべてのデバイス更新ルールのコレクションを戻すために、Get-CsDeviceUpdateRule を呼び出します。次に、このコレクションを、Where-Object コマンドレットにパイプ処理し、Brand が "LG-Nortel" に等しいデバイス更新ルールのみを選択します。
-------------------------- 例 5 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}
例 5 では、承認されていないすべてのデバイス更新ルールのコレクションを戻します。これを行うには、Get-CsDeviceUpdateRules を使用して、すべてのルールのコレクションを戻し、そのコレクションを Where-Object にパイプ処理します。また、Where-Object により、Approved プロパティが NULL 値に等しいルールのみを選択します。Approved プロパティが NULL の場合、これらのルールが承認されていないことを意味します。
-------------------------- 例 6 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}
上記のコマンドは、ルールが承認されている、およびルールが LG-Nortel デバイスに関連するという 2 つの条件を満たす、すべてのデバイス更新ルールのコレクションを戻します。このタスクを実行するには、Get-CsDeviceUpdateRule を呼び出して、組織内のすべてのデバイス更新ルールのコレクションを戻します。そのコレクションを Where-Object にパイプ処理して、Approved プロパティが NULL でない (つまり、このプロパティに何らかの値が指定されている) および Brand が "LG-Nortel" に等しいという 2 つの条件で、コレクションをフィルター処理します。