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 neveTípusDefiní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 neveTípusDefiní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 neveTípusDefiní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
  1. 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.

  2. 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.

  3. 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
  4. 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") {$_} }

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.

A Windows PowerShell parancsfájl-kezelési technikáiról további információt a a Windows PowerShell parancsfájlkezeléssel kapcsolatos útmutatójában talál (előfordulhat, hogy a lap angol nyelven jelenik meg) a Microsoft Script Center webhelyen (https://go.microsoft.com/fwlink/?LinkId=134862).