Az ebben a részben szereplő információk megkönnyítik annak a meghatározását, hogy a Windows Server áttelepítési eszközök parancsmagjainak használatával végrehajtott áttelepítés sikeres vagy sikertelen volt-e. Ha hibák léptek fel az áttelepítés során, az ebben a részben ismertetett hibaelhárítási információk segítségével meghatározhatja a hibák okát.
Az áttelepítés hibaelhárítása
A Windows Server áttelepítési eszközök telepítési naplófájlja a következő helyen található: %windir%\Logs\SmigDeploy.log. A Windows Server áttelepítési eszközök további naplófájljai az alábbi helyeken találhatók.
- %windir%\Logs\ServerMigration.log
- A Windows Server 2008 és a Windows Server 2008 R2 rendszerben: %localappdata%\SvrMig\Log
- A Windows Server 2003 rendszerben: %userprofile%\Local Settings\Application Data\SvrMig\Log
Ha az áttelepítési naplófájlok nem hozhatók létre a fenti helyeken, a rendszer létrehozza a ServerMigration.log és a SmigDeploy.log fájlt a %temp% mappában, valamint további naplófájlokat hoz létre a %windir%\System32 mappában.
A Windows Server áttelepítési eszközök által visszaadott eredményobjektumok tartalmának megtekintése
A Windows Server áttelepítési eszközök minden parancsmagja objektumként adja vissza az eredményeket. Az eredményobjektumokat mentheti, és lekérdezheti, ha további információra van szüksége az áttelepített beállításokról és adatokról. Az eredményobjektumok bemenetként is felhasználhatók a Windows PowerShell más parancsaiban és parancsfájljaiban.
Az eredményobjektumok ismertetése
A Windows Server áttelepítési eszközök Import-SmigServerSetting és Export-SmigServerSetting parancsmagjai az eredményeket egy MigrationResult objektumokat tartalmazó listában adják vissza. Minden MigrationResult objektum információt tartalmaz a parancsmag által feldolgozott adatról vagy beállításról, a művelet eredményéről, valamint az esetleges hibákról és figyelmeztető üzenetekről. Az alábbi táblázat egy MigrationResult objektum tulajdonságait ismerteti.
Tulajdonság neve | Típus | Definíció |
---|---|---|
ItemType | Felsorolás | Az áttelepített elem típusa. A lehetséges értékek a következők: File, Folder, RegistryKey, Share és EncryptedFile. |
ID | Karakterlánc | Az áttelepített elem azonosítója. Néhány lehetséges érték: Local User, Local Group és DHCP. |
Success | Logikai érték | A True érték jelenik meg, ha sikeres az áttelepítés; ellenkező esetben a False érték jelenik meg. |
DetailsList | Lista <ÁttelepítésRészletesEredménye> | A MigrationResultDetails objektumok listája. |
A Send-SmigServerData és Receive-SmigServerData parancsmagok az eredményeket egy MigrationDataResult objektumokat tartalmazó listában adják vissza. Minden MigrationDataResult objektum információt tartalmaz a parancsmag által feldolgozott adatról vagy megosztásról, a művelet eredményéről, az esetleges hibákról vagy figyelmeztető üzenetekről és egyéb kapcsolódó adatról. Az alábbi táblázat egy MigrationDataResult objektum tulajdonságait ismerteti.
Tulajdonság neve | Típus | Definíció |
---|---|---|
ItemType | Felsorolás | Az áttelepített elem típusa. A lehetséges értékek a következők: File, Folder, Share és Encrypted File. |
SourceLocation | Karakterlánc | Az elem elérési útvonalként megjelenő forráshelye. |
DestinationLocation | Karakterlánc | Az elem elérési útvonalként megjelenő célhelye. |
Success | Logikai érték | A True érték jelenik meg, ha sikeres az áttelepítés; ellenkező esetben a False érték jelenik meg. |
Size | Egész szám | Az elem bájtban kifejezett mérete. |
ErrorDetails | Lista <ÁttelepítésRészletesEredménye> | Egyetlen MigrationResultDetails objektum. |
Error | Felsorolás | Az előfordult hibák felsorolása. |
WarningMessageList | Lista <Karakterlánc> | A figyelmeztető üzenetek listája. |
A következő táblázat a MigrationResultDetails objektumon belüli objektumoknak azon tulajdonságait ismerteti, amelyek mind a MigrationResult, mind a MigrationDataResult objektumban gyakran előfordulnak.
Tulajdonság neve | Típus | Definíció |
---|---|---|
Id | Karakterlánc | Az elemre vonatkozó áttelepítési beállítás neve. Néhány lehetséges érték: IPConfig és DNS. Ez a tulajdonság adatáttelepítés esetén üres. |
Messages | Lista <Karakterlánc> | A részletes eseményüzenetek listája. |
DetailCode | Egész szám | A hiba vagy figyelmeztetés eseményüzenetekhez hozzárendelt kódja. |
Severity | Felsorolás | Esemény esetén az esemény súlyossága. Néhány lehetséges érték: Information, Error és Warning. |
Title | Karakterlánc | Az eredményobjektum címe. Néhány lehetséges érték: NIC fizikai cím IP-konfigurácó esetén, vagy felhasználónév helyi felhasználói áttelepítés esetén. |
Példák
A következő példák azt szemléltetik, hogy az eredményobjektumok listája miként tárolható egy változóban, majd a változó segítségével egy lekérdezésben miként adható vissza az eredményobjektumok tartalma az áttelepítés befejezése után.
Eredményobjektumok listájának tárolása lekérdezések változójaként |
Parancsmag futtatásához és az eredmény változóban történő mentéséhez írja be a parancsot a következő formátumban, majd nyomja le az Enter billentyűt.
$VariableName = $(Cmdlet)
Egy példa következik.
$ImportResult = $(Import-SmigServerSetting -FeatureId DHCP -User all -Group -Path D:\rmt\DemoStore -force –Verbose)
Ez a parancs az Import-SmigServerSetting parancsmagot futtatja több megadott paraméterrel, majd az eredményobjektumokat az ImportResult változóba menti.
Miután az Import-SmigServerSetting parancsmag befejezte a műveleteket, adja vissza a következő formátumban megadott megfelelő paranccsal az eredményobjektumban tárolt információt, majd nyomja le az Enter billentyűt.
$VariableName
Az alábbi példában szereplő változó neve ImportResult.
$ImportResult
Ez a parancs az 1. lépésben ismertetett példában szereplő Import-SmigServerSetting parancsmag által visszaadott eredményobjektumok tárolt információit adja vissza. A következő példa az ImportResult változó meghívásakor megjelenített kimenetet mutatja be.
ItemType ID Success DetailsList -------- -- ------- ----------- OSSetting Local User True {Local User, Loc... OSSetting Local Group True {Local Group, Lo... WindowsFeature DHCP True {}
A fenti példában egy elem Import-SmigServerSetting parancsmag használatával történő áttelepítésének eredménye látható. Az oszlopfejlécnevek a MigrationResult objektumok tulajdonságai. Ezeket a tulajdonságokat beépítheti egy másik parancsba is, ha több részletet kíván megjeleníteni az eredményobjektumokról. Ezt szemléltetik a további lépésekben szereplő példák.
A listában szereplő összes eredményobjektum egy adott tulajdonságának megjelenítéséhez írja be a parancsot a következő formátumban, majd nyomja le az Enter billentyűt.
$<VáltozóNeve>| Select-Object -ExpandProperty <TulajdonságNeve>
Egy példa következik.
$importResult | Select-Object -ExpandProperty DetailsList
Az eredményobjektumok elemzéséhez bonyolultabb lekérdezéseket is futtathat a Windows PowerShell parancsmagjainak használatával. Az alábbi parancsok példák.
- E parancs hatására az eredményobjektumoknak csak a Local User azonosítóval rendelkező az adatai jelennek meg.
$ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList
- E parancs hatására az eredményobjektumoknak csak a Local User azonosítóval és a Warning üzenetsúlyossági besorolással rendelkező adatai jelennek meg.
$ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Severity -eq "Warning") {$_} }
- E parancs hatására az eredményobjektumoknak csak a Local User azonosítóval és a Remote Desktop Users címmel rendelkező adatai jelennek meg.
$ImportResult | Where-Object { $_.ID -eq "Local Group" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Title -eq "Remote Desktop Users") {$_} }
- E parancs hatására az eredményobjektumoknak csak a Local User azonosítóval rendelkező az adatai jelennek meg.
További információ a lekérdezési eredményekről
Az előző példákban használt parancsmagokról további információt az alábbi webhelyeken talál.
Where-Object (előfordulhat, hogy a lap angol nyelven jelenik meg) a Microsoft Script Center webhelyen (https://go.microsoft.com/fwlink/?LinkId=134853).Select-Object (előfordulhat, hogy a lap angol nyelven jelenik meg) a Microsoft Script Center webhelyen (https://go.microsoft.com/fwlink/?LinkId=134858).ForEach-Object (előfordulhat, hogy a lap angol nyelven jelenik meg) a Microsoft Script Center webhelyen (https://go.microsoft.com/fwlink/?LinkId=134860).
A Windows PowerShell parancsfájl-kezelési technikáiról további információt a