Move-CsApplicationEndpoint
Ultima modifica dell'argomento: 2012-03-23
Consente di spostare un endpoint in un altro pool di registrazione.
Sintassi
Move-CsApplicationEndpoint -Identity <UserIdParameter> -TargetApplicationPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Questo cmdlet consente di spostare un oggetto contatto endpoint esistente in Servizi di dominio Active Directory da un pool di applicazioni Microsoft Office Communications Server 2007 R2 a un pool di applicazioni Microsoft Lync Server 2010 oppure da un pool di applicazioni Lync Server 2010 a un altro. L'applicazione associata all'endpoint specificato deve esistere sul pool di destinazione. Per stabilire quale applicazione è associata all'endpoint, utilizzare il cmdlet Get-CsTrustedApplicationEndpoint o Get-CsDialInConferencingAccessNumber.
Questo cmdlet consente anche di aggiornare le proprietà dell'oggetto contatto di Active Directory quando un'applicazione distribuita su Office Communications Server 2007 R2 viene ridistribuita su Lync Server 2010. Si noti che in questo caso il pool di applicazioni di origine e di destinazione sarà lo stesso. Inoltre, se si distribuisce direttamente su Lync Server 2010 un'applicazione originariamente messa a punto per Office Communications Server 2007 R2, questo cmdlet deve essere utilizzato con il flag Force per aggiornare le proprietà dell'oggetto contatto di Active Directory.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Move-CsApplicationEndpoint può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsApplicationEndpoint"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
PrimaryUriParameter |
L'indirizzo SIP o il nome distinto del contatto endpoint da spostare. |
TargetApplicationPool |
Obbligatorio |
Fqdn |
Il nome di dominio completo (FQDN) del pool di destinazione dell'endpoint. Il pool di destinazione deve dipendere da un servizio di registrazione. |
DomainController |
Facoltativo |
Fqdn |
Consente di specificare un controller di dominio. Se non è specificato alcun controller di dominio, viene utilizzato il primo disponibile. |
Force |
Facoltativo |
Parametro opzionale |
Questo flag è necessario se si sta spostando un oggetto contatto Microsoft Unified Communications Managed API (UCMA) 2.0 nello stesso pool, ma su una distribuzione di Lync Server 2010. In questo modo, il routing dovrà essere eseguito tramite il servizio di registrazione di Lync Server 2010. |
PassThru |
Facoltativo |
Parametro opzionale |
Se si specifica questo parametro, viene restituito l'oggetto endpoint dell'applicazione dopo che l'oggetto è stato spostato. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Stringa. Accetta una stringa inviata tramite pipeline che rappresenta l'identità dell'endpoint applicazione.
Tipi restituiti
Se viene utilizzato con il parametro PassThru, questo cmdlet restituisce un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Esempio
-------------------------- Esempio 1 --------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint1@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com
In questo esempio, l'oggetto contatto endpoint applicazione con indirizzo SIP endpoint1@litwareinc.com viene spostato nel pool di registrazione attendibile TrustPoolA.litwareinc.com. Utilizzare questo comando per aggiornare un'applicazione da UCMA 2.0 a Microsoft Unified Communications Managed API (UCMA) 3.0 dopo la coesistenza.
-------------------------- Esempio 2 ------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint2@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com -Force
In questo esempio, l'oggetto contatto endpoint applicazione con indirizzo SIP endpoint2@litwareinc.com viene spostato nel pool di registrazione attendibile TrustPoolA.litwareinc.com. In questo caso, a differenza di quanto avveniva nell'Esempio 1, il comando include il parametro Force. Utilizzare questo comando per eseguire la migrazione statica di un'applicazione UCMA 2.0 o la distribuzione diretta di un'applicazione UCMA 2.0 su Lync Server 2010. Questa operazione aggiornerà un oggetto esistente in Active Directory con gli attributi necessari in modo che il routing possa essere eseguito tramite il servizio di registrazione di Lync Server 2010.