Solução de problema da migração baseada em cmdlet

Os cmdlets Ferramentas de Migração do Windows Server Import-SmigServerSetting e Export-SmigServerSetting retornam os resultados em uma lista de objetos MigrationResult. Cada objeto MigrationResult contém informações sobre os dados ou configuração que o cmdlet processa, o resultado da operação e qualquer erro ou mensagens de aviso relacionadas. A tabela a seguir descreve as propriedades de um objeto MigrationResult.

Os cmdlets Send-SmigServerData e Receive-SmigServerData retornam resultados em uma lista de objetos do MigrationDataResult. Cada objeto MigrationDataResult contém informações sobre os dados ou compartilhamento que o cmdlet processa, o resultado da operação, qualquer mensagem de erro ou aviso e outras informações relacionadas. A tabela a seguir descreve as propriedades de um objeto MigrationDataResult.

A tabela a seguir descreve as propriedades dos objetos dentro do objeto MigrationResultDetails que são comuns aos objetos MigrationResult e MigrationDataResult.

Os exemplos a seguir mostram como armazenar a lista de objetos do resultado em uma variável, e então usar a variável em uma consulta para retornar o conteúdo dos objetos do resultado após a conclusão da migração.

1. Para executar um cmdlet e salvar o resultado em uma variável, digite um comando no formato a seguir e pressione Enter.

   $ VariableName = $(Cmdlet)

   Este é um exemplo.

   Copiar

   $ImportResult = $(Import-SmigServerSetting -FeatureId DHCP -User all -Group -Path D:\rmt\DemoStore -force –Verbose)
   

   Esse comando executa o cmdlet Import-SmigServerSetting com vários parâmetros especificados e salva os objetos do resultado na variável ImportResult.

2. Depois que o cmdlet Import-SmigServerSetting completar suas operações, retorne as informações contidas no objeto do resultado digitando um comando no formato a seguir e pressione Enter.

   $ VariableName

   No exemplo a seguir, a variável é chamada ImportResult.

   $ ImportResult

   Esse comando retorna informações contidas nos objetos do resultado que foram retornados pelo Import-SmigServerSetting no exemplo exibido na etapa 1. Este é um exemplo da saída exibida ao chamar a variável ImportResult.

   Copiar

              ItemType  ID                              Success  DetailsList
              --------  --                              -------  -----------
             OSSetting  Local User                         True  {Local User, Loc...
             OSSetting  Local Group                        True  {Local Group, Lo...
        WindowsFeature  DHCP                               True  {}
   
   

   Cada linha da amostra precedente é um resultado da migração de um item que foi migrado usando o cmdlet Import-SmigServerSetting. Os nomes de cabeçalho da coluna são propriedades dos objetos MigrationResult. Você pode incorporar essas propriedades em outro comando para retornar mais detalhes sobre os objetos do resultado, conforme exibido pelos exemplos na etapa 3 e seguinte.

3. Para exibir uma propriedade específica de todos os objetos do resultado na lista, digite um comando no formato a seguir e pressione Enter.

   $<VariableName>| Select-Object -ExpandProperty <PropertyName>

   Este é um exemplo.

   Copiar

   $importResult | Select-Object -ExpandProperty DetailsList
   

4. Você pode executar consultas mais avançadas para analisar os objetos do resultado usando cmdlets Windows PowerShell. Estes são exemplos.

   • O comando a seguir retorna apenas aqueles detalhes dos objetos do resultado que têm a ID Local User.
     
     
     Copiar

     $ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList
     

   • O comando a seguir retorna apenas aqueles detalhes dos objetos do resultado com uma ID do Local User que tenha uma mensagem de severidade igual a Warning.
     
     
     Copiar

     $ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Severity -eq "Warning") {$_} }
     

   • O comando a seguir retorna apenas os detalhes dos objetos do resultado com uma ID do Local User que também tenha o título Remote Desktop Users.
     
     
     Copiar

     $ImportResult | Where-Object { $_.ID -eq "Local Group" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Title -eq "Remote Desktop Users") {$_} }
     

Para obter mais informações sobre os cmdlets usados nos exemplos precedentes, consulte os recursos adicionais a seguir.

• Where-Object [a página pode estar em inglês] no site Microsoft Script Center (http://go.microsoft.com/fwlink/?LinkId=134853).
  
  
• Select-Object [a página pode estar em inglês] no site Microsoft Script Center (http://go.microsoft.com/fwlink/?LinkId=134858).
  
  
• ForEach-Object [a página pode estar em inglês] no site do Microsoft Script Center (http://go.microsoft.com/fwlink/?LinkId=134860)
  
  

Para obter mais informações sobre as técnicas de script do Windows PowerShell, consulte O que posso fazer com o Windows PowerShell? – Técnicas de Script [a página pode estar em inglês] no site do Microsoft Script Center (http://go.microsoft.com/fwlink/?LinkId=134862).