Le informazioni contenute in questa sezione consentono di determinare se la migrazione tramite i cmdlet di Strumenti di migrazione per Windows Server ha avuto esito positivo o negativo. In caso di esito negativo, è possibile utilizzare le informazioni in questa sezione per identificare le cause degli errori.
Risolvere i problemi relativi alla migrazione
Il file di registro della distribuzione di Strumenti di migrazione per Windows Server è incluso in %windir%\Logs\SmigDeploy.log. Vengono inoltre creati file di registro aggiuntivi di Strumenti di migrazione per Windows Server nelle posizioni seguenti.
- %windir%\Logs\ServerMigration.log
- In Windows Server 2008 e Windows Server 2008 R2: %localappdata%\SvrMig\Log
- In Windows Server 2003: %userprofile%\Impostazioni locali\Dati applicazioni\SvrMig\Log
Se non è possibile creare i file di registro della migrazione in queste posizioni, i file ServerMigration.log e SmigDeploy.log vengono creati in %temp%, mentre altri file di registro vengono creati in %windir%\System32.
Visualizzare il contenuto degli oggetti risultato di Strumenti di migrazione per Windows Server
Tutti i cmdlet di Strumenti di migrazione per Windows Server restituiscono i risultati come oggetti. È possibile salvare gli oggetti risultato ed eseguire query su di essi per ottenere ulteriori informazioni sulle impostazioni e i dati migrati. È inoltre possibile utilizzare gli oggetti risultato come input per altri comandi e script di Windows PowerShell.
Descrizioni degli oggetti risultato
I risultati restituiti dai cmdlet di Strumenti di migrazione per Windows Server Import-SmigServerSetting e Export-SmigServerSetting sono costituiti da un elenco di oggetti MigrationResult. Ogni oggetto MigrationResult contiene informazioni sui dati o le impostazioni elaborate dal cmdlet, il risultato dell'operazione e tutti i messaggi di errore o avviso correlati. Le proprietà di un oggetto MigrationResult sono illustrate nella tabella seguente.
Nome proprietà | Tipo | Definizione |
---|---|---|
ItemType | Enum | Tipo di elemento migrato. I valori supportati includono File, Folder, RegistryKey, Share e EncryptedFile. |
ID | Stringa | ID dell'elemento migrato. I valori supportati includono ad esempio Local User, Local Group e DHCP. |
Success | Booleano | Se la migrazione viene completata correttamente verrà visualizzato il valore True, in caso contrario verrà visualizzato il valore False. |
DetailsList | Elenco <MigrationResultDetails> | Elenco di oggetti MigrationResultDetails. |
I risultati restituiti dai cmdlet Send-SmigServerData e Receive-SmigServerData sono costituiti da un elenco di oggetti MigrationDataResult. Ogni oggetto MigrationDataResult contiene informazioni sui dati o le condivisioni elaborate dal cmdlet, il risultato dell'operazione e tutti i messaggi di errore o avviso e altre informazioni correlate. Le proprietà di un oggetto MigrationDataResult sono illustrate nella tabella seguente.
Nome proprietà | Tipo | Definizione |
---|---|---|
ItemType | Enum | Tipo di elemento migrato. I valori supportati includono File, Folder, Share e Encrypted File. |
SourceLocation | Stringa | Percorso di origine dell'elemento, visualizzato come nome di percorso. |
DestinationLocation | Stringa | Percorso di destinazione dell'elemento, visualizzato come nome di percorso. |
Success | Booleano | Se la migrazione viene completata correttamente verrà visualizzato il valore True, in caso contrario verrà visualizzato il valore False. |
Size | Intero | Dimensione dell'elemento in byte. |
ErrorDetails | Elenco <MigrationResultDetails> | Un unico oggetto MigrationResultDetails. |
Error | Enum | Enumerazione degli errori generati. |
WarningMessageList | Elenco di oggetti <stringa> | Elenco di messaggi di avviso. |
Nella tabella seguente sono illustrate le proprietà degli oggetti contenuti nell'oggetto MigrationResultDetails e disponibili anche per gli oggetti MigrationResult e MigrationDataResult.
Nome proprietà | Tipo | Definizione |
---|---|---|
Id | Stringa | Nome dell'impostazione di migrazione correlata all'elemento. I valori supportati includono ad esempio IPConfig e DNS. Per la migrazione dei dati questa proprietà è vuota. |
Messages | Elenco di oggetti <stringa> | Elenco di messaggi di evento dettagliati. |
DetailCode | Intero | Codice di errore o avviso associato a ogni messaggio di evento. |
Severity | Enum | Gravità di un evento, se si è verificato un evento. I valori supportati includono ad esempio Information, Error e Warning. |
Title | Stringa | Titolo dell'oggetto risultato. I valori supportati includono ad esempio l'indirizzo fisico della NIC per la configurazione IP o il nome utente per la migrazione dell'utente locale. |
Esempi
Negli esempi seguenti viene illustrato come archiviare l'elenco degli oggetti risultato in una variabile e quindi utilizzare tale variabile in una query per restituire il contenuto degli oggetti risultato al termine della migrazione.
Per archiviare un elenco di oggetti risultato come variabile per le query |
Per eseguire un cmdlet e salvare il risultato in una variabile, digitare un comando nel formato seguente e quindi premere INVIO.
$VariableName = $(Cmdlet)
Di seguito viene riportato un esempio.
$ImportResult = $(Import-SmigServerSetting -FeatureId DHCP -User all -Group -Path D:\rmt\DemoStore -force –Verbose)
Questo comando esegue il cmdlet con numerosi parametri Import-SmigServerSetting e quindi salva gli oggetti risultato nella variabile ImportResult.
Dopo il completamento delle operazioni del cmdlet Import-SmigServerSetting, per restituire le informazioni contenute nell'oggetto risultato digitare un comando nel formato seguente e quindi premere INVIO.
$VariableName
Nell'esempio seguente la variabile è denominata ImportResult.
$ImportResult
Questo comando restituisce informazioni contenute negli oggetti risultato restituiti da Import-SmigServerSetting nell'esempio illustrato nel passaggio 1. Di seguito viene riportato un esempio dell'output visualizzato quando si chiama la variabile ImportResult.
ItemType ID Success DetailsList -------- -- ------- ----------- OSSetting Local User True {Local User, Loc... OSSetting Local Group True {Local Group, Lo... WindowsFeature DHCP True {}
Ogni riga dell'esempio precedente è un risultato della migrazione di un elemento migrato tramite il cmdlet Import-SmigServerSetting. I nomi delle intestazioni di colonna sono proprietà degli oggetti MigrationResult. È possibile incorporare tali proprietà in un altro comando per restituire informazioni più dettagliate sugli oggetti risultato, come illustrato negli esempi riportati nel passaggio 3 e successivi.
Per visualizzare una proprietà specifica per tutti gli oggetti risultato nell'elenco, digitare un comando nel formato seguente e quindi premere INVIO.
$<NomeVariabile>| Select-Object -ExpandProperty <NomeProprietà>
Di seguito viene riportato un esempio.
$importResult | Select-Object -ExpandProperty DetailsList
È possibile eseguire query più avanzate per analizzare gli oggetti risultato utilizzando i cmdlet di Windows PowerShell. Di seguito vengono riportati alcuni esempi.
- Il comando seguente restituisce solo i dettagli relativi agli oggetti risultato con ID Local User.
$ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList
- Il comando seguente restituisce solo i dettagli relativi agli oggetti risultato con ID Local User e livello di gravità del messaggio Warning.
$ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Severity -eq "Warning") {$_} }
- Il comando seguente restituisce solo i dettagli relativi agli oggetti risultato con ID Local User e titolo Remote Desktop Users.
$ImportResult | Where-Object { $_.ID -eq "Local Group" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Title -eq "Remote Desktop Users") {$_} }
- Il comando seguente restituisce solo i dettagli relativi agli oggetti risultato con ID Local User.
Ulteriori informazioni sull'esecuzione di query sui risultati
Per ulteriori informazioni sui cmdlet utilizzati negli esempi precedenti, vedere le risorse aggiuntive seguenti.
Where-Object nell'area dedicata agli script sul sito Web Microsoft TechNet (https://go.microsoft.com/fwlink/?LinkId=134853).Select-Object nell'area dedicata agli script sul sito Web Microsoft TechNet (https://go.microsoft.com/fwlink/?LinkId=134858).ForEach-Object nell'area dedicata agli script sul sito Web Microsoft TechNet (https://go.microsoft.com/fwlink/?LinkId=134860).
Per ulteriori informazioni sulle tecniche di script di Windows PowerShell, vedere l'