As informações desta secção podem ajudá-lo a determinar se a migração utilizando os cmdlets das Ferramentas de Migração do Windows Server teve êxito ou falhou. Se ocorrerem falhas, poderá utilizar as informações desta secção para o ajudar a investigar as origens da falha.
Resolução de problemas da migração
O ficheiro de registo de implementação das Ferramentas de Migração do Windows Server está localizado em %windir%\Logs\SmigDeploy.log. Os ficheiros de registo adicionais das Ferramentas de Migração do Windows Server são criados nas seguintes localizações.
- %windir%\Logs\ServerMigration.log
- No Windows Server 2008 e no Windows Server 2008 R2: %localappdata%\SvrMig\Log
- No Windows Server 2003: %userprofile%\Local Settings\Application Data\SvrMig\Log
Se não for possível criar os ficheiros de registo nas localizações anteriores, o ServerMigration.log e o SmigDeploy.log serão criados em %temp%, e outros registos serão criados em %windir%\System32.
Visualizar o conteúdo dos objectos de resultados das Ferramentas de Migração do Windows Server
Todos os cmdlets das Ferramentas de Migração do Windows Server devolvem resultados como objectos. Pode guardar os objectos de resultados e consultá-los para obter mais informações sobre definições e dados que tenham sido migrados. Também poderá utilizar os objectos de resultados como entrada para outros comandos e scripts do Windows PowerShell.
Descrições de objectos de resultados
Os cmdlets Ferramentas de Migração do Windows Server Import-SmigServerSetting e Export-SmigServerSetting devolvem resultados numa lista de objectos de MigrationResult. Cada objecto de MigrationResult contém informações sobre os dados ou as definições que o cmdlet processa, o resultado da operação e todas as mensagens de aviso ou de erro relacionadas. A tabela seguinte descreve as propriedades de um objecto de MigrationResult.
Nome da propriedade | Tipo | Definição |
---|---|---|
ItemType | Enum | O tipo de item migrado. Os valores incluem File, Folder, RegistryKey, Share e EncryptedFile. |
ID | Cadeia | O ID do item migrado. Exemplos de valores incluem Local User, Local Group e DHCP. |
Success | Booleano | Se a migração teve êxito é apresentado o valor True, caso contrário, é apresentado False. |
DetailsList | Lista de <MigrationResultDetails> | Uma lista de objectos de MigrationResultDetails. |
Os cmdlets Send-SmigServerData e Receive-SmigServerData devolvem resultados numa lista de objectos de MigrationDataResult. Cada objecto de MigrationDataResult contém informações sobre os dados ou partilhas que o cmdlet processa, o resultado da operação, todas as mensagens de aviso ou de erro e outras informações relacionadas. A tabela seguinte descreve as propriedades de um objecto de MigrationDataResult.
Nome da propriedade | Tipo | Definição |
---|---|---|
ItemType | Enum | O tipo de item migrado. Os valores incluem File, Folder, Share e Encrypted File. |
SourceLocation | Cadeia | A localização de origem do item, apresentada como um nome de caminho. |
DestinationLocation | Cadeia | A localização de destino do item, apresentada como um nome de caminho. |
Success | Booleano | Se a migração teve êxito é apresentado o valor True, caso contrário, é apresentado False. |
Tamanho | Integer | O tamanho do item em bytes. |
ErrorDetails | Lista de <MigrationResultDetails> | Um objecto único de MigrationResultDetails. |
Erro | Enum | Enumeração de erros que ocorreram. |
WarningMessageList | Lista de <Cadeia> | Lista de mensagens de aviso. |
A tabela seguinte descreve as propriedades de objectos no objecto de MigrationResultDetails que são comuns a objectos de MigrationResult e de MigrationDataResult.
Nome da propriedade | Tipo | Definição |
---|---|---|
Id | Cadeia | O nome da definição de migração que está relacionada com o item. Exemplos de valores incluem IPConfig e DNS. Esta propriedade está vazia para migração de dados. |
Mensagens | Lista de <Cadeia> | Lista de mensagens detalhadas do evento. |
DetailCode | Integer | O código de erro ou de aviso associado a cada mensagem do evento. |
Gravidade | Enum | A gravidade de um evento, se ocorrerem eventos. Exemplos de valores incluem Information, Error e Warning. |
Título | Cadeia | Título do objecto de resultado. Os exemplos de valores incluem o endereço físico NIC para a configuração de IP ou nome de utilizador para migração do utilizador local. |
Exemplos
Os exemplos seguintes descrevem a forma de armazenar a lista de objectos de resultado numa variável e, em seguida, utilizar a variável numa consulta para devolver o conteúdo dos objectos de resultado depois de a migração estar concluída.
Para armazenar uma lista de objectos de resultado como uma variável para consultas |
Para executar um cmdlet e guardar o resultado na variável, escreva um comando no formato seguinte e, em seguida, prima Enter.
$VariableName = $(Cmdlet)
Segue-se um exemplo do que foi acima referido.
$ImportResult = $(Import-SmigServerSetting -FeatureId DHCP -User all -Group -Path D:\rmt\DemoStore -force –Verbose)
Este comando executa o cmdlet Import-SmigServerSetting com vários parâmetros especificados e, em seguida, guarda os objectos de resultado na variável ImportResult.
Depois de o cmdlet Import-SmigServerSetting ter concluído as operações, devolva as informações contidas no objecto de resultado escrevendo um comando no seguinte formato e, em seguida, premindo Enter.
$VariableName
No exemplo seguinte, a variável denomina-se ImportResult.
$ImportResult
Este comando devolve as informações contidas nos objectos de resultado, que foram devolvidas com o comando Import-SmigServerSetting no exemplo apresentado no passo 1. Segue-se um exemplo da saída que é apresentada chamando a variável ImportResult.
ItemType ID Success DetailsList -------- -- ------- ----------- OSSetting Local User True {Local User, Loc... OSSetting Local Group True {Local Group, Lo... WindowsFeature DHCP True {}
Cada linha do exemplo anterior é um resultado da migração de um item que foi migrado utilizando o cmdlet Import-SmigServerSetting. Os nomes de cabeçalho da coluna são propriedades de objectos de MigrationResult. Pode incorporar estas propriedades noutro comando para devolver maiores detalhes sobre os objectos de resultado, tal como o apresentado nos passos 3 e seguintes.
Para apresentar uma propriedade específica para todos os objectos de resultado na lista, escreva um comando no formato seguinte e, em seguida, prima Enter.
$<VariableName>| Select-Object -ExpandProperty <PropertyName>
Segue-se um exemplo do que foi acima referido.
$importResult | Select-Object -ExpandProperty DetailsList
Pode executar consultas mais avançadas para analisar objectos de resultado, utilizando os cmdlets do Windows PowerShell. Seguem-se alguns exemplos.
- O seguinte comando devolve apenas os detalhes dos objectos de resultado que têm o ID Local User.
$ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList
- O seguinte comando devolve apenas os detalhes dos objectos de resultado que têm o ID Local User, e que têm uma gravidade de mensagem igual a Warning.
$ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Severity -eq "Warning") {$_} }
- O seguinte comando devolve apenas os detalhes dos objectos de resultado que têm o ID Local User, e que têm também o título Remote Desktop Users.
$ImportResult | Where-Object { $_.ID -eq "Local Group" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Title -eq "Remote Desktop Users") {$_} }
- O seguinte comando devolve apenas os detalhes dos objectos de resultado que têm o ID Local User.
Mais informações sobre resultados da consulta
Para mais informações sobre os cmdlets que são utilizados nos exemplos anteriores, consulte os recursos adicionais seguintes.
Where-Object no Web site do Centro de Scripts da Microsoft (https://go.microsoft.com/fwlink/?LinkId=134853 (pode estar em inglês)).Select-Object no Web site do Centro de Scripts da Microsoft (https://go.microsoft.com/fwlink/?LinkId=134858 (pode estar em inglês)).ForEach-Object no Web site do Centro de Scripts da Microsoft (https://go.microsoft.com/fwlink/?LinkId=134860 (pode estar em inglês)).
Para mais informações sobre as técnicas de processamento de scripts do Windows PowerShell, consulte