Move-CsAnalogDevice
上次修改主題的時間： 2012-03-23
將一或多個類比裝置移至新的登錄器集區。類比裝置是指和公用交換電話網路 (PSTN) 連接的電話或其他裝置。
語法
Move-CsAnalogDevice -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
詳細描述
類比裝置包含電話、傳真機、數據機，以及與公用交換電話網路 (PSTN) 連接的聽障人士電傳通訊裝置 (TTY/TDD)。與利用 Enterprise Voice (Microsoft 提供的 Voice over Internet Protocol (VoIP) 解決方案) 的裝置不同，類比裝置不會使用數位封包傳輸資訊；而是使用連續訊號來傳輸資訊。此訊號通常稱做類比訊號，因此這類裝置稱做「類比裝置」。
為了讓系統管理員能夠管理類比裝置，Microsoft Lync Server 2010 讓您能夠將類比裝置與 Active Directory 連絡人物件產生關聯。在裝置已與連絡人物件產生關聯後，您便可藉由指派原則與撥號對應表至該連絡人，以管理類比裝置。
Move-CsAnalogDevice 指令程式會提供一種方式，讓您能夠將現有類比裝置移至新的登錄器集區。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Move-CsAnalogDevice Cmdlet：RTCUniversalUserAdmins。可以使用 Grant-CsOUPermission 指令程式，為特定站台或特定 Active Directory 組織單位 (OU) 指派執行此指令程式的權限。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsAnalogDevice"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
UserID |
類比裝置的唯一識別碼。類比裝置使用關聯連絡人物件的 Active directory 辨別名稱來識別。根據預設，類比裝置使用 GUID (全域唯一識別碼) 作為一般名稱，這表示裝置的 Identity 通常會與此類似：CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。 |
Target |
必要 |
FQDN |
應移動其類比裝置之登錄器集區的完整網域名稱 (FQDN) (例如，atl-cs-001.litwareinc.com)。除了登錄器集區外，Target 也可以是代管供應商的 FQDN。 |
DomainController |
選用 |
FQDN |
讓您連線至指定的網域控制站，以移動類比裝置。若要連線至特定的網域控制站，請加入 DomainController 參數，後面加上電腦名稱 (例如，atl-cs-001) 或其 FQDN (例如，atl-cs-001.litwareinc.com)。 |
ProxyPool |
選用 |
FQDN |
此參數只能用於 Microsoft Lync Online 2010。請勿用於 Lync Server 的內部部署實作。 |
Force |
選用 |
切換參數 |
如果存在，則會移動類比裝置，但刪除任何關聯的資料 (例如已指派給裝置的原則)。如果不存在，則會連同任何關聯的資料一起移動裝置。 |
PassThru |
選用 |
切換參數 |
讓您透過管線傳遞使用者物件，代表被移動的使用者帳戶。根據預設，Move-CsAnalogDevice 指令程式不會透過管線傳遞任何物件。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串。Move-CsAnalogDevice 接受代表類比裝置之 Identity 的管線傳送字串值。
傳回類型
Move-CsAnalogDevice 預設不會傳回任何物件或值。但是，如果您加上 PassThru 參數，指令程式將傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Move-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -Target atl-cs-001.litwareinc.com
範例 1 所示的命令會將 Identity 為 CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com 的類比裝置移至登錄器集區 atl-cs-001.litwareinc.com。
-------------------------- 範例 2 ------------------------
Get-CsAnalogDevice | Where-Object {$_.DisplayName -eq "Building 14, Room 142"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com
在範例 2 中，會將 Active Directory 顯示名稱為 "Building 14, Room 142" 的類比裝置移至登錄器集區 atl-cs-001.litwareinc.com。為達成此目的，會先呼叫 Get-CsAnalogDevice 且不使用任何參數，以傳回所有目前在組織中使用之類比裝置的集合。然後此集合會傳送到 Where-Object 指令程式，其會選出顯示名稱為 "Building 14, Room 142" 的所有裝置。該篩選過的集合接著會傳送到 Move-CsAnalogDevice，其會將集合中的所有裝置移至新的登錄器集區 atl-cs-001.litwareinc.com。
-------------------------- 範例 3 ------------------------
Get-CsAnalogDevice | Where-Object {$_.DisplayName -like "Building 14*"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com
上述命令會移動顯示名稱是以字串值 "Building 14" 開頭的所有類比裝置。為了執行此作業，命令會先呼叫 Get-CsAnalogDevice 以傳回目前在組織中使用的所有類比裝置集合。此集合接著會傳送到 Where-Object 指令程式，其會選出顯示名稱是以字串值 "Building 14" 開頭的所有裝置。篩選過的集合接著會傳送到 Move-CsAnalogDevice，其會將集合中的每一個裝置移至登錄器集區 atl-cs-001.litwareinc.com。