Move-CsApplicationEndpoint
上次修改主題的時間： 2012-03-23
將端點移至不同的登錄器集區。
語法
Move-CsApplicationEndpoint -Identity <UserIdParameter> -TargetApplicationPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
此指令程式會將 Active Directory 網域服務 (AD DS) 中現有端點連絡人物件從 Microsoft Office Communications Server 2007 R2 應用程式集區移至 Microsoft Lync Server 2010 應用程式集區，或從某個 Lync Server 2010 應用程式集區移至另一個應用程式集區。與指定端點相關聯的應用程式必須存在目標集區上。若要判斷與端點相關聯的應用程式，請執行 Get-CsTrustedApplicationEndpoint 或 Get-CsDialInConferencingAccessNumber指令程式。
當針對 Office Communications Server 2007 R2 部署的應用程式以 Lync Server 2010 重定目標時，此指令程式也用來升級 Active Directory 連絡人物件屬性。請注意，在此情況下，來源和目標應用程式集區相同。另外，如果原本設計以 Office Communications Server 2007 R2 為對象的應用程式直接針對 Lync Server 2010 部署，則此指令程式必須搭配 Force 旗標，才能升級 Active Directory 連絡人物件內容。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Move-CsApplicationEndpoint Cmdlet：RTCUniversalUserAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsApplicationEndpoint"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
主要 Uri 參數 |
您要移動之端點連絡人的 SIP 位址或辨別名稱 (DN)。 |
TargetApplicationPool |
必要 |
Fqdn |
正在向其移動端點之集區的完整網域名稱 (FQDN)。目標集區必須具有登錄器服務相依性。 |
DomainController |
選用 |
Fqdn |
可讓您指定網域控制站。如果未指定網域控制站，則會使用第一個可用的網域控制站。 |
Force |
選用 |
切換參數 |
如果您將 Microsoft Unified Communications Managed API (UCMA) 2.0 連絡人物件移至相同集區，但在 Lync Server 2010 部署上，則此為必要旗標。這樣會強制透過 Lync Server 2010 登錄器進行路由。 |
PassThru |
選用 |
切換參數 |
指定此參數會在物件移動後，傳回應用程式端點物件。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串。接受管線傳送的字串值，代表應用程式端點的 Identity。
傳回類型
搭配 PassThru 參數使用時，傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 類型的物件。
範例
-------------------------- 範例 1 ------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint1@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com
此範例將 SIP 位址為 endpoint1@litwareinc.com 的應用程式端點連絡人物件移至信任的登錄器集區 TrustPoolA.litwareinc.com。共存之後，使用此命令將 UCMA 2.0 應用程式升級至 Microsoft Unified Communications Managed API (UCMA) 3.0 應用程式。
-------------------------- 範例 2 ------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint2@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com -Force
此範例將 SIP 位址為 endpoint2@litwareinc.com 的應用程式端點連絡人物件移至信任的登錄器集區 TrustPoolA.litwareinc.com。此範例不同於範例 1，因為此命令包含 Force 參數。使用此命令以就地移轉 UCMA 2.0 應用程式，或針對單純的 Lync Server 2010 部署來直接部署 UCMA 2.0 應用程式。這樣會以必要屬性更新 Active Directory 中現有的物件，以透過 Lync Server 2010 登錄器進行路由。