New-CsTestDevice
上一次修改主题: 2012-03-26
创建新的设备更新管理测试设备。测试设备为管理员提供了一种方式,用于在将固件更新分发到组织中的所有设备之前测试这些更新。
语法
New-CsTestDevice -Identity <XdsIdentity> -Identifier <String> -IdentifierType <MACAddress | SerialNumber> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsTestDevice -Identifier <String> -IdentifierType <MACAddress | SerialNumber> -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
通过将特定的兼容 Microsoft Lync 2010 Phone Edition 的电话或其他设备标识为测试设备,管理员可以验证和批准固件更新,然后向组织中的相关设备提供这些更新。将设备更新规则导入到 Microsoft Lync Server 2010 中时,这些规则将标记为“待处理”;这意味着受影响的设备不会自动下载并安装与这些规则相对应的更新。
而是任何相关的测试设备将下载并安装这些待处理的规则。测试设备的理念是:新设备更新规则将自动应用到测试设备,从而使管理员有机会验证固件更新是否会按预期工作。如果按预期进行,则这些管理员随后可以将规则标记为已批准;然后组织中的所有相关设备将下载和安装这些已批准规则。
使用 New-CsTestDevice cmdlet 创建测试设备。可在全局范围内或站点范围内配置这些设备。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsTestDevice cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTestDevice"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
指示新测试设备的 Identity。Identity 由要分配测试设备的范围(如 site:Redmond)和新设备的名称(例如 UCPhone)两部分组成。要将名为 UCPhone 的测试设备分配给 Redmond 站点,Identity 参数必须类似于这种形式:-Identity "site:Redmond/UCPhone"。 |
Identifier |
必需 |
字符串 |
根据 IdentifierType,指示新测试设备的媒体访问控制 (MAC) 地址或序列号。可以使用数字、字母、连字符和下划线指定序列号;例如: -Identifier "AB37_679e" 必须将 MAC 地址指定为六个或以上的双字符对;视 MAC 地址而定,这些双字符对可以合并为单个字符串,或者使用连字符或冒号进行分隔。(请注意,MAC 地址可以包括字母和/或数字。)以下每个地址都是有效的 MAC 地址: 010203040506 01-02-03-04-05-06 01:02:03:04:05:06 01-02-03-04-05 之类的 MAC 地址将不会被接受,因为它没有至少六个双字符对。 |
IdentifierType |
必需 |
字符串 |
指示将按其 MAC 地址还是按其序列号唯一地标识测试设备。要按其 MAC 地址标识设备,请将 IdentifierType 设置为 MACAddress。要按其序列号标识设备,请将 IdentifierType 设置为 SerialNumber。仅允许 MACAddress 和 SerialNumber 这两个值。 |
Name |
可选 |
字符串 |
新测试设备的名称(名称在给定范围内必须唯一)。只有在使用 Parent 参数时才应使用 Name 参数。 |
Parent |
可选 |
字符串 |
要分配新测试设备的范围的名称(例如 site:Redmond)。如果使用 Parent 参数,则必须同时使用 Name 参数;例如:-Parent site:Redmond -Name UCPhone。如果使用 Parent 参数,则不应使用 Identity 参数,反之亦然。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
InMemory |
可选 |
开关参数 |
创建对象引用,但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量,您可以更改对象引用的属性,然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsTestDevice 不接受通过管道传递的输入。
返回类型
创建 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice 对象的新实例。
示例
-------------------------- 示例 1 ------------------------
New-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
上述命令为 Redmond 站点创建一个新的测试设备(名为 UCPhone)。注意用于指定设备 Identity 的语法:设备范围 (site:Redmond) 后跟 / 字符再跟设备名称 (UCPhone)。此设备使用序列号作为 IdentifierType,并且序列号为 07823-A345。
-------------------------- 示例 2 ------------------------
New-CsTestDevice -Parent Redmond -Name UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
示例 2 中显示的命令是示例 1 中显示的命令的变体。但是,示例 2 中不使用 Identity 参数。而是使用 Parent 参数指定新测试设备的范围 (site:Redmond),并使用 Name 参数指示新设备的名称 (UCPhone)。New-CsTestDevice cmdlet 将采用这两个参数值,并为您构造测试设备的 Identity (site:Redmond/UCPhone)。