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 eigenschap | Typ | Definitie |
---|---|---|
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 eigenschap | Typ | Definitie |
---|---|---|
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 eigenschap | Typ | Definitie |
---|---|---|
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 |
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.
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.)
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
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") {$_} }
- De volgende opdracht retourneert alleen de gegevens van resultaatobjecten met de id Local User.
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