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 propriedadeTipoDefiniçã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 propriedadeTipoDefiniçã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 propriedadeTipoDefiniçã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
  1. 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.

  2. 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.

  3. 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
  4. 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") {$_} }

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 O que posso fazer com o Windows PowerShell? – Scripting Techniques no Web site do Centro de Scripts da Microsoft (https://go.microsoft.com/fwlink/?LinkId=134862 (pode estar em inglês)).