Move-CsLegacyUser

 

Ultima modifica dell'argomento: 2012-05-21

Consente di eseguire la migrazione di uno o più account da Microsoft Office Communications Server 2007 R2 o Microsoft Office Communications Server 2007 a Microsoft Lync Server 2010.

Sintassi

Move-CsLegacyUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExcludeArchivingPolicy <SwitchParameter>] [-ExcludeConferencingPolicy <SwitchParameter>] [-ExcludeDialPlan <SwitchParameter>] [-ExcludeExternalAccessPolicy <SwitchParameter>] [-ExcludePresencePolicy <SwitchParameter>] [-ExcludeVoicePolicy <SwitchParameter>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

In molte organizzazioni che installano Lync Server 2010 sono in esecuzione anche versioni precedenti del software (Office Communications Server 2007 R2 o Office Communications Server 2007). Questo fatto comunque non rappresenta un problema: è possibile eseguire contemporaneamente entrambe le versioni del software. Nel tempo è possibile iniziare la migrazione delle impostazioni di configurazione, dei criteri ed infine degli account utente verso Lync Server 2010.

Il cmdlet Move-CsLegacyUser non solo consente di eseguire la migrazione degli utenti a Lync Server 2010, ma offre anche la possibilità di esercitare un notevole controllo sul processo di migrazione. Ad esempio, nella forma più semplice, è possibile assegnare a Move-CsLegacyUser l'identità dell'utente di cui si intende eseguire la migrazione e il nome di dominio completo del pool di registrazione di Lync Server 2010 in cui verrà inserito l'account utente. A sua volta, Move-CsLegacyUser sposterà l'account utente e manterrà tutti i criteri e le impostazioni esistenti applicati all'account. Ad esempio, si supponga che a Davide Garghentini sia stato assegnato un dial plan in Office Communications Server. Per impostazione predefinita, quando si esegue la migrazione dell'account di Ken, la migrazione riguarda anche il rispettivo dial plan: Ciò significa che Move-CsLegacyUser assegnerà automaticamente a Davide Garghentini il dial plan di Lync Server 2010 equivalente a quello che gli era stato assegnato nella versione Communications Server 2007 R2.

Ovviamente, questo si verifica solo se è stata eseguita la migrazione dei dial plan e se esiste un dial plan in Lync Server 2010 equivalente a quello assegnato a Davide Garghentini nella versione Communications Server 2007 R2. In alternativa, sarebbe stato possibile scegliere di installare Lync Server 2010 senza eseguire la migrazione dei dial plan. In quel caso, è possibile utilizzare il cmdlet Move-CsLegacyUser insieme al parametro ExcludeDialPlan. Quando si usa questo parametro, non viene eseguita la migrazione dei dial plan insieme all'account utente: questo significa che l'account utente di Davide Garghentini verrà spostato su Lync Server 2010, ma non gli verrà assegnato alcun dial plan. Questo si verifica anche nel caso in cui sia stata eseguita la migrazione dei dial plan. Il parametro ExcludeDialPlan impedisce che all'account utente oggetto della migrazione venga assegnato un dial plan. Altri parametri consentono di escludere i criteri vocali, i criteri di conferenza, i criteri di archiviazione, i criteri di accesso esterno e/o i criteri di presenza durante la migrazione degli account utente.

Prima di eseguire Merge-CsLegacyTopology, è necessario installare il pacchetto di interfacce per la compatibilità con le versioni precedenti di Strumentazione gestione Windows (WMI). Questa applicazione viene installata eseguendo OCSWMIBC.msi, disponibile sul DVD di installazione nella cartella di installazione. Dopo aver installato il pacchetto di interfacce per la compatibilità, è possibile chiamare Merge-CsLegacyUser per spostare uno o più account utente da Communications Server 2007 R2 o Communications Server 2007 a Lync Server 2010.

Se è necessario riportare un utente da Lync Server indietro a Office Communications Server non utilizzare il cmdlet Move-CsLegacyUser. Utilizzare invece il cmdlet Move-CsUser e il nome di dominio completo del precedente pool di Office Communications Server come valore del parametro Target di Move-CsUser. Ad esempio:

Move-CsUser –Identity "Davide Garghentini" –Target "ocs13.litwareinc.com"

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Move-CsLegacyUser 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-CsLegacyUser"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Indica l'identità dell'account utente di cui eseguire la migrazione. Le identità utente possono essere specificate con uno dei quattro formati riportati di seguito: 1) l'indirizzo SIP dell'utente; 2) il nome dell'entità utente (UPN); 3) il nome del dominio e il nome di accesso dell'utente nel formato dominio\accesso (ad esempio, litwareinc\davidegarghentini); 4) il nome visualizzato Servizi di dominio Active Directory dell'utente (ad esempio, Davide Garghentini). Alle identità utente è anche possibile fare riferimento utilizzando il nome distinto Active Directory dell'utente.

È possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il nome visualizzato come identità utente. Ad esempio, l'identità "* Smith" restituisce tutti gli utenti con un nome visualizzato che termina con la stringa " Smith".

Target

Obbligatorio

Stringa

FQDN del pool di registrazione dove l'account utente deve essere domiciliato. Ad esempio: -Target atl-cs-001.litwareinc.com.

DomainController

Facoltativo

Stringa

Consente di connettersi al controller di dominio specificato per spostare un account utente. Per la connessione a un controller di dominio specifico, includere il parametro DomainController seguito dal nome computer (ad esempio, atl-cs-001) o dal suo FQDN (ad esempio, atl-cs-001.litwareinc.com).

ExcludeArchivingPolicy

Facoltativo

Parametro opzionale

Se presenti, tutti i criteri di archiviazione assegnati all'account utente non verranno mantenuti durante la migrazione dell'account.

ExcludeConferencingPolicy

Facoltativo

Parametro opzionale

Se presenti, tutti i criteri di conferenza assegnati all'account utente non verranno mantenuti durante la migrazione dell'account.

ExcludeDialPlan

Facoltativo

Parametro opzionale

Se presente, qualsiasi dial plan assegnato all'account utente non verrà mantenuto durante la migrazione dell'account.

ExcludeExternalAccessPolicy

Facoltativo

Parametro opzionale

Se presente, qualsiasi criterio di accesso esterno assegnato all'account utente non verrà mantenuto durante la migrazione dell'account.

ExcludePresencePolicy

Facoltativo

Parametro opzionale

Se disponibili, tutti i criteri di presenza assegnati all'account utente non verranno mantenuti durante la migrazione dell'account.

ExcludeVoicePolicy

Facoltativo

Parametro opzionale

Se presenti, tutti i criteri vocali assegnati all'account utente non verranno mantenuti durante la migrazione dell'account.

ProxyPool

Facoltativo

Stringa

Questo parametro è utilizzato solo per Microsoft Lync Online 2010. Non deve essere utilizzato con un'implementazione locale di Lync Server.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

PassThru

Facoltativo

Parametro opzionale

Consente di specificare attraverso la pipeline un oggetto utente che rappresenta l'account utente che si sta spostando. Per impostazione predefinita, il cmdlet Move-CsLegacyUser non passa oggetti attraverso la pipeline.

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

Nessuno. Move-CsLegacyUser non accetta input tramite pipeline.

Tipi restituiti

Move-CsLegacyUser non restituisce valori o oggetti. Invece, il cmdlet sposta le istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser.

Esempio

-------------------------- Esempio 1 ------------------------

Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"

Nell'esempio precedente, il cmdlet Move-CsLegacyUser è utilizzato per eseguire la migrazione dell'account utente con identità Luisa Cazzaniga al pool di registrazione atl-cs-001.litwareinc. Poiché non sono inclusi altri parametri, verrà eseguita la migrazione anche di tutti i criteri o di tutte le impostazioni precedentemente assegnate all'account. Questo significa che se un criterio precedente (ad esempio un dial plan) era stato assegnato a Luisa Cazzaniga, a questa stessa persona verrà assegnato il criterio equivalente in Lync Server 2010 quando verrà spostato l'account.

-------------------------- Esempio 2 ------------------------

Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -ExcludeDialPlan 

Il comando riportato nell'Esempio 2 mostra la migrazione dell'account utente di Luisa Cazzaniga, ma non esegue la migrazione dei dial plan precedentemente assegnati al suo account. Al termine della migrazione dell'account, Pilar non disporrà di un dial plan assegnato.

-------------------------- Esempio 3 ------------------------

Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"

Nell'Esempio 3 tutti gli account utente nell'unità organizzativa Finance vengono spostati nel pool di registrazione atl-cs-001.litwareinc.com inLync Server. Per eseguire questa operazione, il comando utilizza prima Get-CsUser e il parametro OU per recuperare una raccolta di tutti gli account utente nell'unità organizzativa Finance. Dopo aver recuperato gli account la raccolta viene inviata tramite pipe a Move-CsLegacyUser, che sposta ciascun account al nuovo pool di registrazione. Questo comando assume che tutti gli utenti nella OU Finance siano utenti precedenti.

-------------------------- Esempio 4 ------------------------

Get-CsUser -UnassignedUser | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"

Nell'esempio precedente, Move-CsLegacyUser viene utilizzato per assegnare un pool di registrazione a tutti gli utenti abilitati per Lync Server ma non attualmente assegnati ad un pool di registrazione. In questo comando, il cmdlet Get-CsUser viene utilizzato insieme al parametro UnassignedUser per ottenere una raccolta di tutti gli utenti che attualmente non sono assegnati ad un pool di registrazione. Questa raccolta viene inviata tramite pipe al cmdlet Move-CsLegacyUser che assegna ciascun utente al pool di registrazione atl-cs-001.litwareinc.com Questo esempio assume che tutti gli utenti non assegnati siano utenti precedenti.