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 cmdlet 用于返回有关已导入供在组织中使用的设备更新规则的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsDeviceUpdateRule cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDeviceUpdateRule"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
设备更新规则的唯一标识符。设备更新规则的标识由两部分组成：已采用该规则的 service 作用域（如 service:WebServer:atl-cs-001.litwareinc.com）和预先分配给该规则的全局唯一标识符 (GUID)（如 d5ce3c10-2588-420a-82ac-dc2d9b1222ff9）。根据上述内容，给定设备更新规则的标识将如下所示："service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9"。 指定 Identity 时不允许使用通配符。如果要在指定规则时使用通配符，请使用 Filter 参数。 |
Filter |
可选 |
字符串 |
使您可以在指定一个或一组设备更新规则的 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 中显示的命令返回有关 Identity 为“WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9”的设备更新规则的信息。
-------------------------- 示例 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*”。该筛选器将返回的数据限制为 Identity 以字符串值“service:WebServer:atl-cs-001.litwareinc.com”开头的设备更新规则。
-------------------------- 示例 4 --------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"}
上述命令返回 Brand 属性等于“LG-Nortel”的所有设备更新规则。为执行此操作，调用了 Get-CsDeviceUpdateRule 以便返回组织中的所有设备更新规则的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅选择 Brand 等于“LG-Nortel”的规则。
-------------------------- 示例 5 --------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}
示例 5 返回尚未批准的所有设备更新规则的集合。这是通过以下方式实现的：使用 Get-CsDeviceUpdateRules 返回所有规则的集合，然后将该集合通过管道传递到 Where-Object。接下来，Where-Object 会仅选择 Approved 属性等于空值的规则。如果 Approved 属性为空，则表示这些规则尚未批准。
-------------------------- 示例 6 --------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}
上面显示的命令返回满足以下两个条件的所有设备更新规则的集合：规则已获批准以及规则与 LG-Nortel 设备相关。为完成此任务，首先调用 Get-CsDeviceUpdateRule，以便返回组织中的所有设备更新规则的集合。然后，将该集合通过管道传递到 Where-Object，后者会根据以下两个条件来筛选集合：Approved 属性不能为空（也就是说，此属性必须具有某种类型的值）；以及 Brand 必须等于“LG-Nortel”。