Import-CsDeviceUpdate
上一次修改主题： 2012-03-23
导入从 Microsoft 网站下载的一组设备更新规则。设备更新规则用于将固件版本更新与运行 Microsoft Lync 2010 Phone Edition 的硬件设备相关联。
语法
Import-CsDeviceUpdate -Identity <XdsIdentity> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft 会定期发布一组适用于 Lync 2010 Phone Edition 的新设备更新规则。这些规则代表运行 Lync 2010 Phone Edition 的设备的固件更新。导入这些规则后，管理员就可以测试固件更新，然后在假定测试成功的情况下，可以使这些更新可用于组织中使用的所有相关设备。
创建新的更新规则的唯一方法是从 Microsoft 下载更新包；您不能自行创建设备更新规则。要获取一组最新的设备更新规则，请转至 Microsoft 网站上的帮助和支持页并搜索“Phone Edition”。下载更新包，并将文件解压缩到计算机上要从中上载更新的文件夹。解压缩文件后，可以使用 Import-CsDeviceUpdate cmdlet 导入解压缩后的 .CAB 文件（其名称为 UCUpdates.cab）中包含的设备更新规则。
如前所述，只能在本地加载更新；您需要将 UCUpdates.cab 复制到运行 Web 服务 服务且需要托管设备更新规则的所有计算机。另外请记住，设备更新规则不会在服务器之间复制。如果要使组织中的所有设备更新规则保持同步，则需要在托管这些规则的每个服务器上执行相同的操作。例如，如果从一个 Web 服务服务器中删除某条规则，则需要从其他 Web 服务服务器中删除相同规则。否则，设备更新规则将不再同步。
只能将更新规则导入到服务；它们不适用于 global 作用域、site 作用域或每用户作用域。但是，请注意 Import-CsDeviceUpdate 不会自动将规则和更新添加到站点中的每个服务；它只将这些规则和更新加载到指定的服务。例如，如果站点中有三个运行 Web 服务的服务器，则需要运行三次 Import-CsDeviceUpdate，分别对 Web 服务的每个实例运行一次。或者，也可以使用类似示例 3 中显示的命令；此命令将检索所有 Web 服务服务器的标识，然后针对其中每个服务器运行 Import-CsDeviceUpdate。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Import-CsDeviceUpdate cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsDeviceUpdate"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
指示将应用新更新规则的服务实例。例如：-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 |
FileName |
可选 |
字符串 |
更新文件的路径（例如 C:\Updates\UCUpdates.cab）。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Import-CsDeviceUpdate 不接受通过管道传递的输入。
返回类型
Import-CsDeviceUpdate cmdlet 导入 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule 类的实例。
示例
-------------------------- 示例 1 --------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName C:\Updates\UCUpdates.cab
示例 1 中显示的命令从文件 C:\Updates\UCUpdates.cab 中导入设备更新规则。
-------------------------- 示例 2 --------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName \\atl-fs-001\Updates\UCUpdates.cab
示例 2 中显示的命令从 UNC 路径 \\atl-fs-001\Updates\UCUpdates.cab 中导入设备更新规则。
-------------------------- 示例 3 --------------------------
Get-CsService -WebServer | ForEach-Object {Import-CsDeviceUpdate -Identity $_.Identity -FileName C:\Updates\UCUpdates.cab}
示例 3 说明如何使用单个命令将设备更新规则导入到所有运行 Web 服务的服务器中。为执行此操作，该命令首先调用带有 WebServer 参数的 Get-CsService，以返回运行 Web 服务的所有服务器的集合。然后，将该集合通过管道传递到 ForEach-Object cmdlet，后者将遍历集合中的每个服务器，并使用 Import-CsDeviceUpdate 将最新的设备更新规则更新到这些服务器。请注意，仅当将 UCUpdates.cab 复制到所有服务器上的相同位置 (C:\Updates) 后，此命令才有效。