Eseguire la migrazione di un'installazione del server DHCP a un altro Windows Server

La migrazione del server DHCP comporta lo spostamento delle impostazioni per il server DHCP esistente in un nuovo server DHCP nella rete. L'obiettivo di questa migrazione del server è installare il ruolo del server DHCP nel sistema operativo Windows Server in modo che fornisca lease DHCP in una rete senza alcuna modifica percepibile ai computer client DHCP.

Questa guida descrive i passaggi per la migrazione delle impostazioni del server DHCP esistenti a un server che esegue Windows Server. Usando questa guida per eseguire la migrazione di un server DHCP, è possibile semplificare la migrazione, ridurre il tempo di migrazione, aumentare l'accuratezza del processo di migrazione e contribuire a eliminare possibili conflitti che potrebbero verificarsi altrimenti durante la migrazione DHCP. Questa guida non contiene istruzioni per la migrazione quando il server di origine esegue più ruoli. Se il server esegue più ruoli, è consigliabile progettare una procedura di migrazione personalizzata specifica per l'ambiente server. Alcune note sulla migrazione:

• Sono supportate le migrazioni tra sistemi operativi fisici e sistemi operativi virtuali.
• La migrazione da un server di origine a un server di destinazione che esegue un sistema operativo in una lingua dell'interfaccia utente di sistema diversa da quella del server di origine non è supportata.
• La migrazione è consigliata invece di un aggiornamento anche quando l'hardware è basato su x64 nativo.

Questa guida è destinata agli amministratori IT, ai professionisti IT e ad altri knowledge worker responsabili del funzionamento e della distribuzione di server DHCP in un ambiente gestito. L'amministratore del server può scegliere quali componenti di un'installazione esistente eseguire la migrazione. Insieme al ruolo del server, questi componenti in genere includono le impostazioni di configurazione, dati, identità del sistema e sistema operativo.

Prerequisites

• Un server DHCP esistente configurato e in esecuzione
• Nel server di origine e nel server di destinazione sono necessarie le autorizzazioni seguenti:
  • Diritti amministrativi del dominio necessari per autorizzare il server DHCP.
  • I diritti amministrativi locali sono necessari per installare o gestire il server DHCP.
  • Le autorizzazioni di scrittura sono necessarie per il percorso dell'archivio di migrazione.

Processo di migrazione del server

La migrazione del server DHCP è suddivisa nelle sezioni principali seguenti:

• Preparare la migrazione: il processo di premigration prevede la raccolta manuale dei dati, seguita da passaggi per preparare i server di destinazione e di origine.
• Eseguire la migrazione del ruolo server DHCP: il processo di migrazione include le procedure del server di origine e di destinazione che usano i cmdlet Di esportazione e importazione per raccogliere, archiviare e quindi eseguire la migrazione delle impostazioni del ruolo del server.
• Verificare la migrazione: verificare che il server di destinazione abbia sostituito correttamente il server di origine.
• Completare le attività successive alla migrazione: ritirare o riconfigurare il server di origine. Risolvere i problemi di migrazione in caso di errore ed eseguire il rollback, se necessario.

Preparare la migrazione

• Identificare i server di origine e di destinazione del server DHCP.

• Determinare il dominio, il nome del server e le password nel server di origine. Per identificare il dominio del server originale, visualizzare Impostazioni di sistema dal Pannello di controllo.

• Prima della migrazione, installare tutti gli aggiornamenti critici e i Service Pack nel server di origine. È consigliabile che tutti gli aggiornamenti critici e i Service Pack correnti siano installati sia nei server di origine che nei server di destinazione.

• Contare il numero di schede di rete nei server di origine e di destinazione e assicurarsi che siano uguali in numero. Se il server di origine che esegue il server DHCP dispone di più schede di rete e il servizio server DHCP è associato a tutti gli indirizzi IP e gestisce indirizzi IP in subnet diverse, il server di destinazione che esegue il server DHCP deve avere anche più schede di rete in modo che possa servire le stesse subnet del server di origine.

• Preparare il percorso del file di archiviazione della migrazione. La posizione del negozio deve essere accessibile dal server di origine durante l'esportazione e dal server di destinazione durante l'importazione. Usare un'unità comune che può contenere tutte le informazioni correlate al server DHCP dal server di origine. Il percorso di archiviazione dovrebbe essere simile al seguente: \\fileserver\users\username\.

Installare gli strumenti di migrazione

Se non è già stato fatto, installare Strumenti di migrazione di Windows Server nei server di destinazione e di origine. Gli strumenti di migrazione possono essere installati usando PowerShell o Server Manager.

Per PowerShell, usare il cmdlet Install-WindowsFeature :

Install-WindowsFeature -Name Migration -ComputerName Server1

Usare Server Manager e aprire la Procedura guidata Aggiungi ruoli e funzionalità. Trovare e installare la funzionalità Strumenti di migrazione di Windows Server.

Preparare il server di destinazione

Per installare il server DHCP nel server di destinazione, completare il processo di installazione basato su menu. Completare la procedura seguente per preparare il server di destinazione.

Per preparare il server di destinazione

1. Installare Windows Server e configurare il server di destinazione.

2. Assicurarsi che lo spazio su disco sia sufficiente per archiviare il database del server DHCP. Lo spazio su disco necessario varia a seconda di ogni installazione e deve essere uguale o maggiore dello spazio per il database del server DHCP.

3. Aggiungere il server di destinazione come server membro nel dominio del server di origine da sostituire.

4. Verificare che il server di destinazione possa risolvere i nomi degli utenti di dominio membri del gruppo locale durante l'operazione di importazione. Se i server di origine e di destinazione si trovano in domini diversi, il server di destinazione deve essere in grado di contattare un server di catalogo globale per la foresta in cui si trovano gli account utente del dominio di origine.

5. In un computer che esegue Windows Server aprire Windows PowerShell come amministratore.

6. Caricare il modulo Server Manager nella sessione di Windows PowerShell. Per caricare il modulo Server Manager, immettere il comando :

   Import-Module -Name ServerManager
   

   Note

   Non è obbligatorio che il server DHCP sia installato nel server di destinazione prima di importare le impostazioni. Se il ruolo non è installato nel server di destinazione, verrà installato automaticamente durante il processo di importazione. Tuttavia, poiché l'installazione del ruolo durante l'importazione potrebbe prolungare i tempi di inattività, è consigliabile installare il server DHCP usando la console di Server Manager nel server di destinazione come parte della preparazione per la migrazione.

7. Nel server di destinazione eseguire il comando seguente per installare il server DHCP:

   Install-WindowsFeature -Name DHCP
   

È anche possibile installare manualmente il server DHCP tramite Server Manager. Per altre informazioni, vedere Installare e configurare il server DHCP.

1. Al termine del processo di migrazione, il server di destinazione deve avere un indirizzo IP statico. Anche se ora non modificherai l'indirizzo IP del server di destinazione, prendi in considerazione i seguenti scenari in preparazione alla modifica dell'indirizzo quando la migrazione sarà completata.

   • Se il tuo scenario di migrazione richiede di mettere fuori servizio e scollegare il server di origine dalla rete, solo allora potrai impostare l'indirizzo IP sul server di destinazione uguale a quello del server di origine. Il server di origine deve essere disconnesso dalla rete o arrestato in modo che non vi sia alcun conflitto di indirizzi IP tra il server di origine e il server di destinazione. Tuttavia, il server di destinazione può comunque servire i client che cercano il server legacy (di origine) che esegue il server DHCP.

   • Se lo scenario di migrazione richiede di continuare a eseguire il server di origine nella rete per altri scopi non DHCP, è necessario assegnare al server di destinazione un indirizzo IP non allocato nella stessa subnet del server di origine per evitare conflitti IP.

   • I client server DHCP che tentano di rinnovare un lease di indirizzi IP inviano la richiesta di rinnovo all'indirizzo IP precedente del server DHCP. Se il server di origine è stato rimosso e quindi disconnesso dalla rete e il nuovo server di destinazione DHCP funziona con un indirizzo IP diverso, la richiesta ha inizialmente esito negativo a causa dell'indirizzo IP modificato. Tuttavia, i client tentano di ritrovare l'indirizzo IP del server DHCP nella rete e quindi recuperare da questo errore temporaneo.

   Warning

   Se il server di origine esegue più ruoli, rinominare il server di origine o modificarne l'indirizzo IP può causare l'esito negativo di altri ruoli in esecuzione nel server di origine.

2. Se il percorso del database del server DHCP non corrisponde al percorso predefinito, è necessario assicurarsi che il server di destinazione disponga di un disco con la stessa lettera di unità visualizzata nel percorso del database del server DHCP del server di origine.

Il server di destinazione è ora preparato per la migrazione.

Preparare il server di origine

Seguire questa procedura per preparare il server di origine per la migrazione.

1. Eseguire il backup del server di origine. Il backup deve essere un backup specifico del server DHCP, non un backup di Windows. Un backup di Windows esegue il backup del sistema operativo completo. È possibile creare il backup specifico del server DHCP usando lo strumento da riga di comando Netsh o Microsoft Management Console (MMC).

2. Se è in esecuzione, arrestare il servizio server DHCP. In una sessione aperta come descritto nel passaggio 5 della preparazione del server di destinazione immettere:

   Stop-Service -Name "DHCPserver"
   

3. Se il percorso del database del server DHCP non corrisponde al percorso predefinito, assicurarsi che il server di destinazione disponga di un disco con la stessa lettera di unità del percorso del server DHCP del server di origine.

A questo punto è possibile iniziare la migrazione del server DHCP.

Eseguire la migrazione del ruolo del server DHCP

In questa sezione si eseguirà la migrazione del server DHCP al server di destinazione dal server di origine. L'appartenenza a Amministratori di dominio o equivalente è il requisito minimo necessario per completare queste procedure.

Eseguire la migrazione del server DHCP al server di destinazione

1. Se non è già installato, installare il server DHCP nel server di destinazione.

2. Se è in esecuzione, arrestare il servizio DHCP eseguendo il seguente comando:

   Stop-Service -Name "DHCPserver"
   

Eseguire la migrazione del server DHCP dal server di origine

Seguire la procedura descritta in questa sezione per eseguire la migrazione del server DHCP dal server di origine.

Important

Prima di eseguire i cmdlet Import-SmigServerSetting, Export-SmigServerSetting o Get-SmigServerFeature , verificare che durante la migrazione i server di origine e di destinazione possano contattare il controller di dominio associato a utenti o gruppi di dominio membri di gruppi locali nel server di origine. Prima di eseguire i cmdlet Send-SmigServerData o Receive-SmigServerData , verificare che durante la migrazione i server di origine e di destinazione possano contattare il controller di dominio associato a tali utenti di dominio proprietari di file o condivisioni di cui viene eseguita la migrazione.

1. In un computer che esegue Windows Server aprire Windows PowerShell come amministratore.

2. Caricare Gli strumenti di migrazione di Windows Server nella sessione.

   Se è stata aperta la sessione corrente usando il collegamento Strumenti di migrazione di Windows Server dal menu Start , ignorare questo passaggio e andare al passaggio 3. Caricare esclusivamente lo snap-in Strumenti di migrazione di Windows Server in una sessione aperta utilizzando un metodo diverso, e in cui lo snap-in non sia già stato caricato. Per caricare Strumenti di migrazione di Windows Server, digitare quanto segue e quindi premere INVIO.

   Add-PSSnapin Microsoft.Windows.ServerManager.Migration
   

3. Raccogliere dati dal server di origine eseguendo il cmdlet Export-SmigServerSetting come amministratore. I parametri del cmdlet Export-SmigServerSetting possono raccogliere tutti i dati del server DHCP di origine in un singolo file (Svrmig.mig). In alternativa, il cmdlet Export-SmigServerSetting può essere eseguito più volte, con ogni iterazione usando uno o più parametri per raccogliere e archiviare i dati in più file Svrmig.mig. Prima di eseguire questo comando, esaminare quanto segue:

   • Quando si esegue il comando nel passaggio 4, viene richiesto di specificare una password per crittografare i dati dell'archivio di migrazione. È necessario specificare questa stessa password per l'importazione dall'archivio di migrazione.

   • Il parametro path può essere una directory vuota o non vuota. Il file di dati effettivo nella directory (Svrmig.mig) viene creato dal cmdlet Export-SmigServerSetting . Pertanto, l'utente non deve specificare un nome file.

   • Se il percorso non è un percorso condiviso da cui il server di destinazione può leggere, è necessario copiare manualmente l'archivio di migrazione nel server di destinazione o in un percorso accessibile dal server di destinazione.

   • Se esiste già un percorso dell'archivio di migrazione e si vuole eseguire nuovamente il cmdlet Export-SmigServerSetting , è necessario spostare il file Svrmig.mig da tale percorso e archiviarlo altrove, rinominare o eliminare prima l'archivio migrazione.

   • È possibile eseguire sia la migrazione ip che il server DHCP contemporaneamente da un prompt di Windows PowerShell usando il cmdlet Export-SmigServerSetting combinato con l'opzione IPConfig , su una singola riga di comando.

   • Informazioni aggiuntive sui parametri della riga di comando:

     • -Users e -Group parameters

       Il parametro -Users deve essere specificato solo se il gruppo Administrators DHCP include utenti locali. In caso contrario, è possibile usare il parametro -Group e verrà eseguita la migrazione di tutti i membri degli amministratori DHCP. I membri del gruppo di amministratori possono includere utenti di dominio.

       Important

       Se il server di origine è un controller di dominio, ma il server di destinazione non lo è, i gruppi locali di dominio vengono migrati come gruppi locali e gli utenti di dominio vengono migrati come utenti locali.

     • Il parametro -IPConfig raccoglie informazioni IP quando viene usato con il cmdlet Export-SmigServerSetting nel server di origine; Il parametro -IPConfig applica le impostazioni quando viene usato il cmdlet Import-SmigServerSetting nel server di destinazione.

       Se il server DHCP di origine dispone di più schede di rete e il servizio server DHCP è associato a più schede di rete e gestisce indirizzi IP in subnet diverse, il server DHCP di destinazione deve avere anche più schede di rete in modo che possa servire le stesse subnet del server DHCP di origine. Poiché i dettagli di configurazione IP verranno usati in un secondo momento durante l'importazione delle impostazioni di configurazione IP nel server di destinazione, è consigliabile salvare le impostazioni di configurazione IP usando il comando seguente: IPConfig /all > IPSettings.txt.

       Il cmdlet Import-SmigServerSetting richiede di eseguire il mapping dell'indirizzo fisico di origine all'indirizzo fisico di destinazione.

     Note

     È possibile assegnare al server di destinazione lo stesso indirizzo IP statico del server di origine, a meno che non siano ancora in esecuzione altri ruoli nel server di origine. In tal caso, l'indirizzo IP statico del server di destinazione può essere qualsiasi indirizzo IP statico non allocato nella stessa subnet del server di origine.

4. Nel server di origine eseguire il cmdlet Export-SmigServerSetting , dove <storepath> è il percorso che contiene il file Svrmig.mig al termine di questo passaggio. Un esempio del percorso è \\fileserver\users\username\dhcpstore.

   Export-SmigServerSetting -featureID DHCP -User All -Group -IPConfig -path <storepath> -Verbose
   

5. Nel server di origine eliminare l'autorizzazione DHCP per il server DHCP di origine eseguendo il comando seguente, dove FQDN server è il nome di dominio completo (FQDN) del server DHCP e IPAddress del server DHCP è l'indirizzo IP del server. I parametri del comando fanno distinzione tra maiuscole e minuscole e devono essere visualizzati esattamente come illustrato.

   Netsh DHCP delete server <Server FQDN> <Server IPAddress>
   

Completare la migrazione nel server di destinazione

Tornare al server di destinazione e seguire questa procedura per completare la migrazione.

1. Prima di usare il cmdlet Import-SmigServerSetting per importare le impostazioni del server DHCP, tenere presente le condizioni seguenti:

   • È possibile usare una singola riga di comando con tutti i parametri per importare le impostazioni DHCP (come quando si esportano dati dal server di origine) oppure è possibile usare il cmdlet più volte per importare dati un parametro alla volta.

   • Se si decide di eseguire il cmdlet Import-SmigServerSetting separatamente per importare le impostazioni IP, usare il file di origine IPSettings.txt, indicato nel passaggio 3 della procedura precedente. Eseguire il mapping degli indirizzi fisici di origine agli indirizzi fisici di destinazione nel passaggio 3 di questa procedura. Se si prevede di importare separatamente le impostazioni ip e ruolo, è necessario importare prima di tutto le impostazioni IP per evitare conflitti IP. È quindi possibile importare il ruolo DHCP.

   • Se il gruppo Amministratori DHCP include utenti locali, usare il parametro -Users combinato con il parametro -Group per importare gli utenti locali nel gruppo Amministratori DHCP. Se contiene solo utenti di dominio, usare solo il parametro -Group .

   Note

   Se il server di origine è un server membro di dominio, ma il server di destinazione è un controller di dominio, gli utenti locali importati vengono elevati agli utenti di dominio e i gruppi locali importati diventano gruppi locali di dominio nel server di destinazione.

   • Se il ruolo server DHCP di cui si esegue la migrazione non è stato installato nel server di destinazione, il cmdlet Import-SmigServerSetting installa il ruolo server DHCP e le relative dipendenze. Potrebbe essere necessario riavviare il computer di destinazione per completare l'installazione dopo l'installazione del ruolo Server DHCP dal cmdlet . Quindi, per completare l'operazione di importazione dopo il riavvio del computer, è necessario eseguire di nuovo il cmdlet Import-SmigServerSetting insieme al parametro -Force .

2. Nel server di destinazione eseguire il comando seguente, dove <storepath> è il percorso disponibile che contiene il file Svrmig.mig, <SourcePhysicalAddress-1> e <SourcePhysicalAddress-2> sono elenchi delimitati da virgole degli indirizzi fisici della scheda di rete di origine e TargetPhysicalAddress-1< e><TargetPhysicalAddress-2> sono elenchi delimitati da virgole degli indirizzi fisici della scheda di rete di destinazione:

   Import-SmigServerSetting -FeatureID 'DHCP' -User All -Group -IPConfig <All | Global | NIC>
       -SourcePhysicalAddress <SourcePhysicalAddress-1>,<SourcePhysicalAddress-2>
       -TargetPhysicalAddress <TargetPhysicalAddress-1>,<TargetPhysicalAddress-2>
       -Force -Path <storepath> -Verbose
   

   L'opzione -IPConfig deve essere usata con il valore Tutto nel caso in cui l'utente voglia importare tutte le impostazioni di origine.

   Important

   Se si importa l'indirizzo IP del server di origine nel server di destinazione insieme al ruolo DHCP senza disconnettersi o modificare l'indirizzo IP del server di origine, si verificherà un conflitto di indirizzi IP.

3. Eseguire il comando seguente per avviare il servizio DHCP: Start-Service -Name "DHCPServer"

4. Autorizzare il server di destinazione. I parametri dei comandi fanno distinzione tra maiuscole e minuscole e devono essere visualizzati esattamente come illustrato. Nel server di destinazione eseguire il comando seguente in cui FQDN del server è il nome di dominio completo del server DHCP e ipAddress del server DHCP è l'indirizzo IP del server:

   netsh DHCP add server <Server FQDN> <Server IPAddress>
   

Al termine della migrazione, i computer client nel server di rete vengono gestiti dal nuovo server di destinazione basato su x64 che esegue Windows Server. La migrazione viene completata quando il server di destinazione è pronto per gestire gli indirizzi IP alla rete.

Verificare la migrazione

Al termine di tutti i passaggi di migrazione, è possibile usare la procedura seguente per verificare che la migrazione del ruolo del server DHCP abbia avuto esito positivo. Se la migrazione non è riuscita, è possibile tornare alla configurazione valida precedente seguendo i passaggi descritti in Attività post-migrazione.

Verificare la configurazione del server di destinazione

Seguire questa procedura per verificare che il server di destinazione DHCP stia ora servendo il dominio.

1. Assicurarsi che il server di destinazione sia autorizzato eseguendo il comando seguente in una finestra di Windows PowerShell:

   netsh DHCP show server
   

   L'output di questo comando deve contenere il nome del server di destinazione DHCP.

2. Controllare se il server DHCP è in esecuzione nel server di destinazione. In Gestione attività, nella scheda Servizi , lo stato del server DHCP deve essere Avviato. È anche possibile usare Gestione attività per verificare che lo stato del server di origine sia Arrestato.

3. Verificare che i computer client ricevano correttamente gli indirizzi IP su richiesta eseguendo i comandi seguenti al prompt dei comandi in un computer client:

   ipconfig /release
   
   ipconfig /renew
   

   Se l'indirizzo IP del server DHCP non è stato modificato, non è necessario eseguire il comando ipconfig /release . L'esecuzione di ipconfig /renew deve essere sufficiente.

   L'output di questi comandi dovrebbe indicare che il computer client è stato emesso un indirizzo IP.

4. Usare la console DHCP per verificare che sia stata eseguita la migrazione degli ambiti e di altre impostazioni. Per connettersi al server di destinazione, selezionare Azione, selezionare Aggiungi server e quindi digitare l'indirizzo IP o il nome host del server DHCP. Nell'albero della console espandere il nodo del server e quindi espandere i nodi IPv4 e IPv6 per verificare che gli ambiti siano stati migrati. Individuare quindi le cartelle per gli ambiti e visualizzare l'intervallo di indirizzi, le prenotazioni, le opzioni di ambito e i lease attivi per verificare lo stesso. È anche possibile passare alla cartella Opzioni server e verificare le opzioni del server di cui è stata eseguita la migrazione.

Attività successive alla migrazione

Queste attività successive alla migrazione per il server di origine sono facoltative, a seconda dello scenario di migrazione.

La migrazione è stata completata dopo aver verificato che il server di destinazione, non il server di origine, stia ora servendo la rete.

Ritirare DHCP nel server di origine

Dopo aver verificato la migrazione, è possibile disconnettere, riutilizzare o ritirare il server di origine. Se il server di origine esegue altri ruoli del server, deve essere lasciato nella rete. Se non è necessario usare questo computer, è possibile archiviarlo come backup nel caso in cui sia necessario ripristinare la configurazione DHCP precedente.

Se lo scenario di migrazione include un server DHCP autonomo, questo server di origine è stato portato offline dopo la creazione del file di esportazione. In questo scenario, il servizio DHCP è stato interrotto dal momento in cui è stato arrestato fino al completamento della migrazione nel nuovo server.

Se lo scenario di migrazione include più server DHCP in un dominio, un backup o un altro server DHCP continua a servire gli indirizzi IP durante la migrazione in modo che i servizi ai client non vengano mai interrotti. La migrazione viene completata nel nuovo server quando viene eseguita la migrazione dell'indirizzo IP del server di origine al server di destinazione.

Ritirare il server di origine

Dopo aver verificato che il server di destinazione esegue le funzioni gestite in precedenza dal server di origine, è possibile ritirare o riconfigurare il server di origine, a seconda delle esigenze. Seguire i criteri dell'organizzazione relativi alla rimozione delle autorizzazioni del server. Per informazioni sulla rimozione delle autorizzazioni di un controller di dominio, vedere Demoting domain controllers and domains.For information about decommissioning a domain controller, see Demoting domain controllers and domains.

Ripristinare DHCP se la migrazione non riesce

Se la migrazione del server DHCP non riesce, sono disponibili queste opzioni:

• Se il server di origine non è stato riconfigurato, un amministratore può riassegnare le impostazioni di configurazione IP, riautorizzare il server e riavviare il servizio DHCP nel server originale.
• Usare i file di backup creati nel server di origine per ripristinare il server DHCP nel server DHCP originale.

Risolvere i problemi di migrazione basata su cmdlet

Il file di log di distribuzione degli strumenti di migrazione di Windows Server si trova in %windir%\Logs\SmigDeploy.log. Altri file di log dei Strumenti di trasferimento di Windows Server vengono creati nei seguenti percorsi.

• % windir%\Logs\ServerMigration.log

• % localappdata%\SvrMig\Log

Se i file di log della migrazione non possono essere creati nei percorsi precedenti, ServerMigration.log e SmigDeploy.log vengono creati in %temp% e altri log vengono creati in %windir%\System32.

Per suggerimenti per la risoluzione dei problemi specifici di DHCP, vedere Risolvere i problemi nei server DHCP.

Se non è possibile ripristinare le connessioni tra i server di origine o di destinazione e i controller di dominio o i server di catalogo globale

1. Prima di eseguire di nuovo Export-SmigServerSetting, Import-SmigServerSetting o Get-SmigServerFeature , rimuovere tutti gli utenti o i gruppi di dominio non risolti membri di gruppi locali dal server in cui si esegue il cmdlet.

2. Prima di eseguire nuovamente Send-SmigServerData o Receive-SmigServerData , rimuovere tutti gli utenti o i gruppi di dominio non risolti con diritti utente per file, cartelle o condivisioni nel server di origine della migrazione.

Visualizzare il contenuto degli oggetti risultato di Strumenti di migrazione di Windows Server

Tutti i cmdlet di Strumenti di migrazione di Windows Server restituiscono i risultati come oggetti. È possibile salvare gli oggetti risultato ed eseguirne una query per altre informazioni sulle impostazioni e i dati di cui è stata eseguita la migrazione. È anche possibile usare gli oggetti risultato come input per altri comandi e script di Windows PowerShell.

Descrizioni degli oggetti risultato

I cmdlet Import-SmigServerSetting e Export-SmigServerSetting di Windows Server Migration Tools restituiscono risultati in un elenco di oggetti MigrationResult . Ogni oggetto MigrationResult contiene informazioni sui dati o sull'impostazione elaborati dal cmdlet, sul risultato dell'operazione e su eventuali messaggi di errore o di avviso correlati. Nella tabella seguente vengono descritte le proprietà di un oggetto MigrationResult .

Nome proprietà	Type	Definition
ItemType	Enum	Tipo di elemento di cui eseguire la migrazione. I valori includono Generale, WindowsFeatureInstallation, WindowsFeature e OSSetting.
ID	String	ID dell'elemento migrato. Esempi di valori includono Utente locale, Gruppo locale e DHCP.
Success	Boolean	Il valore True viene visualizzato se la migrazione ha avuto esito positivo; in caso contrario, viene visualizzato False .
DetailsList	List<MigrationResultDetails>	Elenco di oggetti MigrationResultDetails .

I cmdlet Send-SmigServerData e Receive-SmigServerData restituiscono risultati in un elenco di oggetti MigrationDataResult. Ogni oggetto MigrationDataResult contiene informazioni sui dati o sulla condivisione elaborati dal cmdlet, il risultato dell'operazione, eventuali messaggi di errore o di avviso e altre informazioni correlate. Nella tabella seguente vengono descritte le proprietà di un oggetto MigrationDataResult .

Nome proprietà	Type	Definition
ItemType	Enum	Tipo di elemento migrato. I valori includono File, Cartella, Condivisione e File crittografato.
SourceLocation	String	Posizione di origine dell'elemento, visualizzata come percorso.
DestinationLocation	String	Posizione di destinazione dell'elemento, visualizzata come percorso.
Success	Boolean	Il valore True viene visualizzato se la migrazione ha avuto esito positivo; in caso contrario, viene visualizzato False .
Size	Integer	Dimensioni dell'elemento, in byte.
ErrorDetails	List<MigrationResultDetails>	Elenco di oggetti MigrationResultDetails .
Error	Enum	Enumerazione degli errori che si sono verificati.
WarningMessageList	List<String>	Elenco di messaggi di avviso.

Nella tabella seguente vengono descritte le proprietà degli oggetti all'interno dell'oggetto MigrationResultDetails comuni agli oggetti MigrationResult e MigrationDataResult .

Nome proprietà	Type	Definition
FeatureId	String	Nome dell'impostazione di migrazione correlata all'elemento. Esempi di valori includono IPConfig e DNS. Questa proprietà è vuota allo scopo di migrazione dei dati.
Messages	List<String>	Elenco di messaggi di evento dettagliati.
DetailCode	Integer	Codice di errore o avviso associato a ogni messaggio di evento.
Severity	Enum	Gravità di un evento, se si sono verificati eventi. Esempi di valori includono Informazioni, Errore e Avviso.
Title	String	Titolo dell'oggetto risultato. Esempi di valori includono l'indirizzo fisico della scheda di rete per la configurazione IP o il nome utente per la migrazione dell'utente locale.