Get-CsTestDevice
上次修改主題的時間： 2012-03-23
擷取已設定為在組織中使用之裝置更新管理測試裝置的相關資訊。測試裝置提供一種方式，讓系統管理員先測試韌體更新，然後再將這些更新散布到組織中的所有裝置。
語法
Get-CsTestDevice [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsTestDevice [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
藉由識別特定 Microsoft Lync 2010 Phone Edition 相容電話或其他裝置作為測試裝置，系統管理員可以在將韌體更新部署至組織中的所有相關裝置之前，驗證並核准這些更新。裝置更新規則在匯入至 Microsoft Lync Server 2010 後，會被標記為「擱置」，表示受影響的裝置將不會自動安裝並安裝這些規則的對應更新。
但是，任何相關的測試裝置將會下載並安裝這些擱置的規則。那就是測試裝置的目的，適用於：新的裝置更新規則會自動套用至測試裝置，讓系統管理員有機會確認韌體更新是否如預期般運作。若是如此，這些系統管理員就可以將規則標示為核准；之後，組織中所有相關的裝置就會下載並安裝核准的規則。
測試裝置可以指派給通用範圍或網站範圍。您可以使用 Get-CsTestDevice 指令程式，來擷取設定為目前要在組織內使用之測試裝置的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsTestDevice Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTestDevice"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
表示要傳回之測試裝置的 Identity。若要參考名稱為 UCPhone 的個別裝置 (儲存於通用集合中)，請使用以下語法：-Identity global/UCPhone。若要參考在網站集合中找到的裝置，請使用類似如下的語法：-Identity site:Redmond/UCPhone。若要參考整個集合，請省略裝置名稱。例如，以下語法會傳回針對 Redmond 網站設定的所有測試裝置：-Identity site:Redmond。 請注意，指定 Identity 時，無法使用萬用字元。 |
Filter |
選用 |
字串 |
提供一種方式，讓您在指定要傳回之測試裝置時使用萬用字元。例如，若要傳回已在站台範圍設定的所有測試裝置集合，請使用以下語法：-Filter "site:*"。若要傳回 Identity 中有 "EMEA" 一詞的所有裝置，請使用以下語法：-Filter "*EMEA*"。請注意，Filter 只能在測試裝置集合的 Identity 上有作用；您無法針對其他集合屬性進行篩選。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取測試裝置資料，而非從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsTestDevice 不接受管線傳送的輸入。
傳回類型
Get-CsTestDevice 傳回 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice 物件的一個或多個執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsTestDevice
範例 1 會傳回組織中的所有測試裝置。呼叫不含其他任何參數的 Get-CsTestDevice 時，將會傳回目前使用中的所有測試裝置。
-------------------------- 範例 2 ------------------------
Get-CsTestDevice -Identity site:Redmond/UCPhone
以上的範例會傳回指派給 Redmond 網站且名稱為 UCPhone 的測試裝置。
-------------------------- 範例 3 ------------------------
Get-CsTestDevice -Identity site:Redmond
在範例 3 中，此命令會傳回針對 Redmond 網站設定的所有測試裝置。
-------------------------- 範例 4 ------------------------
Get-CsTestDevice -Filter site:*
以上的命令會傳回已在網站範圍設定的所有測試裝置。若要這樣做，此命令會使用 Filter 參數；篩選值 "site:*" 會將傳回的資料限制為 Identity 開頭為字串值 "site:" 的測試裝置。