Move-CsExUmContact
上次修改主題的時間： 2012-03-23
將一個或多個 Exchange Unified Messaging (UM) 連絡人移到新的登錄器集區。
語法
Move-CsExUmContact -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 搭配 Exchange UM 一起提供多項語音相關功能，包括自動語音應答和訂閱者存取。Move-CsExUmContact 提供一個方法，讓您將現有的 Exchange UM 連絡人物件移到新的登錄器集區。可以將連絡人物件從 Microsoft Office Communications Server 2007 或 Microsoft Office Communications Server 2007 R2 集區移到 Lync Server 2010 集區，或從某個 Lync Server 2010 集區移到另一個集區。此指令程式不會將 Exchange UM 連絡人物件從 Lync Server 2010 集區移到 Office Communications Server 2007 或 Office Communications Server 2007 R2 集區。
移動 Exchange UM 連絡人物件時，會根據該物件的 OtherIpPhone 內容值適當地設定 AutoAttendant 和 IsSubscriberAccess 內容。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Move-CsExUmContact Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsExUmContact"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
UserIdParameter |
您要移動之連絡人物件的唯一識別碼。可以使用下列四種格式的其中一種來指定連絡人識別身分：1) 連絡人的 SIP 位址；2) 連絡人的使用者主體名稱 (UPN)；3) 連絡人的網域名稱和登入名稱，格式為 domain\logon (例如，litwareinc\exum1)；以及 4) 連絡人的 Active Directory 顯示名稱 (例如，Team Auto Attendant)。 |
Target |
必要 |
Fqdn |
連絡人要移往之登錄器集區的完整網域名稱 (FQDN)。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
DomainController |
選用 |
Fqdn |
可讓您連線至指定的網域控制站。若要連線至特定的網域控制站，請加入 DomainController 參數，後面加上電腦名稱 (例如，atl-mcs-001) 或其 FQDN (例如，atl-mcs-001.litwareinc.com)。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
PassThru |
選用 |
切換參數 |
讓您透過管線傳遞連絡人物件，代表被移動的連絡人帳戶。根據預設，Move-CsExUmContact 指令程式不會透過管線傳遞物件。 |
ProxyPool |
選用 |
Fqdn |
此參數只能用於主控的 Lync Server 執行個體。請勿用於 Lync Server 的內部部署實作。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
輸入類型
字串。接受管線傳送的字串值，代表要移動之 Exchange UM 物件的 Identity。
傳回類型
使用 PassThru 參數呼叫時，會傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 類型的物件。
範例
-------------------------- 範例 1 ------------------------
Move-CsExUmContact -Identity "sip:exum1@fabrikam.com" -Target atl-cs-001.litwareinc.com
範例 1 會將 SIP 位址為 exum1@fabrikam.com 的 Exchange UM 連絡人物件移到 FQDN 為 atl-cs-001.litwareinc.com 的登錄器集區。請注意，執行此命令時，即使未加入 Confirm 參數也會在畫面上顯示確認提示。即使加入 Force 參數，一樣會出現此提示。
-------------------------- 範例 2 ------------------------
Get-CsExUmContact | Where-Object {$_.AutoAttendant -eq $True} | Move-CsExUmContact -Target atl-cs-001.litwareinc.com
此範例會將屬於「自動語音應答」的所有 Exchange UM 連絡人物件移到 FQDN 為 atl-cs-001.litwareinc.com 的登錄器集區。範例會先呼叫 Get-CsExUmContact，以擷取已經定義的所有 Exchange UM 連絡人。然後將這個連絡人集合傳送到 Where-Object 指令程式，以在集合中尋找 AutoAttendant 內容值為 True ($True) 的所有連絡人，該值表示連絡人屬於「自動語音應答」。
最後，會將 AutoAttendant 為 True 的連絡人集合傳送到 Move-CsExUmContact 指令程式，以將這些連絡人移到 Target 參數中指定的登錄器集區。
如範例 1 所示，執行此命令時，會出現確認提示。