Aan de hand van de informatie in deze sectie kunt u vaststellen of de migratie met behulp van Hulpprogramma's voor migratie van Windows-servers-cmdlets is gelukt of is mislukt. Wanneer er zich fouten voordoen, kunt u met deze informatie de bron van de fouten proberen op te sporen.

Migratieproblemen oplossen

Het Hulpprogramma's voor migratie van Windows-servers-implementatielogboek bevindt zich in %windir%\Logs\SmigDeploy.log. ExtraHulpprogramma's voor migratie van Windows-servers-logboekbestanden worden op de volgende locaties gemaakt:

  • %windir%\Logs\ServerMigration.log

  • In Windows Server 2008 en Windows Server 2008 R2: %localappdata%\SvrMig\Log

  • In Windows Server 2003: %userprofile%\Local Settings\Application Data\SvrMig\Log

Als er op deze locaties geen migratielogboeken kunnen worden gemaakt, worden ServerMigration.log en SmigDeploy.log in %temp% gemaakt en worden de andere logboeken in %windir%\System32 gemaakt.

De inhoud van de resultaten van de hulpprogramma's voor migratie van Windows-servers als objecten bekijken

Resultaten worden door alle Hulpprogramma's voor migratie van Windows-servers-cmdlets als objecten geretourneerd. U kunt resultaatobjecten opslaan en meer informatie over de gemigreerde gegevens en instellingen opvragen. Tevens kunt u resultaatobjecten gebruiken als invoer voor andere opdrachten en scripts van Windows PowerShell.

Beschrijvingen van resultaatobjecten

De cmdlets Hulpprogramma's voor migratie van Windows-servers Import-SmigServerSetting en Export-SmigServerSetting retourneren resultaten als een lijst MigrationResult-objecten. Elk MigrationResult-object bevat informatie over de gegevens of instellingen die door de cmdlet worden verwerkt, het resultaat van de bewerking en elk fout- of waarschuwingsbericht dat daarmee verband houdt. In de volgende tabel worden de eigenschappen van een MigrationResult-object beschreven.

Naam van eigenschapTypDefinitie

ItemType

Enum

Het type gemigreerd item. Waarden zijn onder andere File, Folder, RegistryKey, Share en EncryptedFile.

Id

Tekenreeks

De id van het gemigreerde item. Voorbeelden van waarden zijn Local User, Local Group en DHCP.

Success

Boolean

De waarde True wordt weergegeven als de migratie met goed gevolg is uitgevoerd. In het andere geval wordt False weergegeven.

DetailsList

Lijst <MigrationResultDetails>

Een lijst met MigrationResultDetails-objecten.

De cmdlets Send-SmigServerData en Receive-SmigServerData cmdlets retourneren resultaten als een lijst MigrationDataResult-objecten. Elk MigrationDataResult-object bevat informatie over de gegevens of shares die door de cmdlet worden verwerkt, het resultaat van de bewerking, elk fout- of waarschuwingsbericht dat daarmee verband houdt, en andere verwante informatie. In de volgende tabel worden de eigenschappen van een MigrationDataResult-object beschreven.

Naam van eigenschapTypDefinitie

ItemType

Enum

Het type gemigreerd item. Waarden zijn onder andere File, Folder, Share en Encrypted File.

Bronlocatie

Tekenreeks

De bronlocatie van het item die als een padnaam wordt weergegeven.

DestinationLocation

Tekenreeks

De doellocatie van het item die als een padnaam wordt weergegeven.

Success

Boolean

De waarde True wordt weergegeven als de migratie met goed gevolg is uitgevoerd. In het andere geval wordt False weergegeven.

Size

Integer

De grootte van het item in bytes.

ErrorDetails

Lijst <MigrationResultDetails>

Een enkel MigrationResultDetails-object.

Error

Enum

Opsomming van de fouten die zijn opgetreden.

WarningMessageList

Lijst <tekenreeks>

Een lijst met waarschuwingsberichten.

In de volgende tabel worden de eigenschappen beschreven van objecten in het MigrationResultDetails-object. Dit zijn de algemene eigenschappen voor de MigrationResult- en MigrationDataResult-objecten.

Naam van eigenschapTypDefinitie

Id

Tekenreeks

De naam van de migratie-instelling die verband houdt met het item. Voorbeelden van waarden zijn IPConfig en DNS. Deze eigenschap is leeg voor gegevensmigraties.

Berichten

Lijst <tekenreeks>

Een lijst met gedetailleerde gebeurtenisberichten.

DetailCode

Integer

De fout- of waarschuwingscode van elk gebeurtenisbericht.

Severity

Enum

De ernst van een gebeurtenis als er zich gebeurtenissen voordoen. Voorbeelden van waarden zijn Information, Error en Warning.

Titel

Tekenreeks

De titel van het resultaatobject. Voorbeelden van waarden zijn het fysieke adres van de netwerkkaart voor de IP-configuratie of de gebruikersnaam voor de lokale gebruikersmigratie.

Voorbeelden

In de volgende voorbeelden ziet u hoe de lijst met resultaatobjecten in een variabele wordt opgeslagen en hoe vervolgens met die variabele in een query de inhoud van resultaatobjecten wordt geretourneerd nadat de migratie is voltooid.

Een lijst met resultaatobjecten als een variabele voor query's opslaan
  1. Om een cmdlet uit te voeren en het resultaat in een variabele op te slaan typt u een opdracht in de volgende notatie waarna u op Enter drukt.

    $VariableName = $(Cmdlet)

    De volgende opdracht is hier een voorbeeld van.

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

    Deze opdracht voert de cmdlet Import-SmigServerSetting met diverse opgegeven parameters uit en slaat vervolgens de resultaatobjecten in de variabele ImportResult op.

  2. Nadat de bewerkingen door de cmdlet Import-SmigServerSetting zijn uitgevoerd, retourneert u de gegevens uit het resultaatobject door een opdracht in de volgende notatie op te geven en vervolgens op Enter te drukken.

    $VariableName

    In het volgende voorbeeld is ImportResult de variabele.

    $ImportResult

    Deze opdracht retourneert de gegevens uit de resultaatobjecten die zijn geretourneerd door Import-SmigServerSetting in het voorbeeld uit stap 1. Het volgende is een voorbeeld van de uitvoer die wordt weergegeven na aanroeping van de variabele ImportResult.

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

    Elke regel van het vorige voorbeeld is een migratieresultaat voor een item dat is gemigreerd met behulp van de cmdlet Import-SmigServerSetting. De namen van de kolomkoppen zijn eigenschappen van MigrationResult-objecten. U kunt deze eigenschappen in een andere opdracht opnemen en zo gedetailleerdere informatie over de resultaatobjecten krijgen. (Zie hiervoor de voorbeelden vanaf stap 3.)

  3. Om een bepaalde eigenschap voor alle resultaatobjecten uit de lijst weer te geven typt u een opdracht in de volgende notatie waarna u op Enter drukt.

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

    De volgende opdracht is hier een voorbeeld van.

    $importResult | Select-Object -ExpandProperty DetailsList
  4. U kunt geavanceerdere query's uitvoeren en met behulp van de Windows PowerShell-cmdlets resultaatobjecten analyseren. De volgende opdrachten zijn hier voorbeelden van.

    • De volgende opdracht retourneert alleen de gegevens van resultaatobjecten met de id Local User.

      $ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList
    • De volgende opdracht retourneert alleen de gegevens van resultaatobjecten met de id Local User die een berichternst Warning hebben.

      $ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Severity -eq "Warning") {$_} }
    • De volgende opdracht retourneert alleen de gegevens van resultaatobjecten met de id Local User die ook de titel Remote Desktop Users hebben.

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

Meer informatie over het uitvoeren van query's op resultaten

Zie de volgende aanvullende informatiebronnen voor meer informatie over de cmdlets uit de vorige voorbeelden.

  • Where-Object op de Microsoft Script Center-website (https://go.microsoft.com/fwlink/?LinkId=134853) (pagina is mogelijk Engelstalig).

  • Select-Object op de Microsoft Script Center-website (https://go.microsoft.com/fwlink/?LinkId=134853) (pagina is mogelijk Engelstalig).

  • ForEach-Object op de Microsoft Script Center-website (https://go.microsoft.com/fwlink/?LinkId=134860) (pagina is mogelijk Engelstalig).

Zie Wat kan ik doen met Windows PowerShell? – Scripttechnieken op de Microsoft Script Center-website (https://go.microsoft.com/fwlink/?LinkId=134862) voor meer informatie over de scripttechnieken van Windows PowerShell (pagina is mogelijk Engelstalig).