Troubleshooting Cmdlet-based Migration

To run a cmdlet and save the result in variable, type a command in the following format, and then press Enter.

$VariableName = $(Cmdlet)

The following is an example.

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

This command runs the Import-SmigServerSetting cmdlet with several parameters specified, and then saves result objects in the variable ImportResult.

After the Import-SmigServerSetting cmdlet has completed its operations, return the information contained in the result object by typing a command in the following format, and then pressing Enter.

$VariableName

In the following example, the variable is named ImportResult.

$ImportResult

This command returns information contained in the result objects that were returned by Import-SmigServerSetting in the example shown in step 1. The following is an example of the output that is displayed by calling the ImportResult variable.

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

Each line of the preceding sample is a migration result for an item that was migrated by using the Import-SmigServerSetting cmdlet. The column heading names are properties of MigrationResult objects. You can incorporate these properties into another command to return greater detail about result objects, as shown by examples in step 3 and forward.

To display a specific property for all result objects in the list, type a command in the following format, and then press Enter.

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

The following is an example.

$importResult | Select-Object -ExpandProperty DetailsList

You can run more advanced queries to analyze result objects by using Windows PowerShell cmdlets. The following are examples.

• The following command returns only those details of result objects that have the ID Local User.
  
  

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

• The following command returns only those details of result objects with an ID of Local User that have a message severity equal to Warning.
  
  

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

• The following command returns only the details of result objects with an ID of Local User that also have the title Remote Desktop Users.
  
  

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