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：下列群組的成員預設會獲授權可以在本機上執行 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 指令程式將會採用這兩個參數值，並為您建構測試裝置 Identity (site:Redmond/UCPhone)。