OneDrive KFM hibaelhárítás 2026

Frissítve: 2026. szeptember 12.

Az OneDrive Known Folder Move (KFM) hibaelhárítás során a helpdesk csapatnak először azt kell ellenőriznie, hogy a felhasználó bejelentkezett-e a OneDrive kliensbe a megfelelő munkahelyi fiókkal, majd a KFMSilentOptIn és KFMSilentOptInWithNotification beállításkulcsokat kell megvizsgálnia. A leggyakoribb hibák (eltűnt asztali ikonok, „Ez a mappa már át van irányítva" üzenet, félbeszakadt szinkronizálás) 90%-ban tenant azonosító elírásra, elavult OneDrive verzióra vagy hiányzó GPO/Intune házirendre vezethetők vissza. Ebben az útmutatóban 11 év helpdesk tapasztalatból összegyűjtött diagnosztikai lépéseket, PowerShell szkripteket és valós hibakódokat találsz.

A KFM három ismert mappát irányít át OneDrive-ra: Asztal, Dokumentumok, Képek. A Zenék, Videók és Letöltések mappa nem érintett.
A csendes átirányításhoz OneDrive sync kliens 22.176.0821.0002 vagy újabb, valamint a tenant azonosító helyes beírása szükséges.
Ha a felhasználó asztali parancsikonjai (LNK fájljai) hibás célt mutatnak KFM után, a C:\Users\%username%\OneDrive - Cégnév\Desktop az új útvonal.
A KFM visszavonása után a fájlok NEM másolódnak vissza automatikusan a helyi mappákba, ezt a helpdesknek kézzel vagy szkripttel kell megoldania.
Az Intune Administrative Templates (ADMX) 2024 óta hivatalosan támogatja a OneDrive konfigurációt, cseréli a klasszikus GPO-t hibrid környezetben.
A leggyakoribb hibakódok: 0x8004de40 (auth), 0x8007016A (Files On-Demand konfliktus), 0x8004de85 (tenant mismatch).

Mi az a Known Folder Move és miért olyan törékeny?

A Known Folder Move (magyarul „Ismert mappák áthelyezése") egy OneDrive funkció, amely automatikusan átirányítja a Windows három szabványos felhasználói mappáját (Asztal, Dokumentumok, Képek) a OneDrive szinkronizálási könyvtárba. A cél kettős. Egyrészt biztosítja, hogy a felhasználó adatai eszközcserénél ne vesszenek el, másrészt egy központi backup-stratégiát ad a szervezetnek anélkül, hogy külön kliens telepítésére lenne szükség.

Őszintén szólva, a KFM azért törékeny a gyakorlatban, mert a Windows Explorer, a OneDrive sync engine, a felhasználói profil és a Group Policy motor egyszerre nyúlkálnak ugyanabba a ShellFolder regisztrációba. Egy 400 fős céges rollout során a mi csapatunk azt tapasztalta, hogy a felhasználók kb. 12%-ánál valamilyen szinten félresikerül az átirányítás. Vagy azért, mert korábban egy custom mappa lett beállítva Desktopnak (pl. egy megosztott hálózati meghajtón), vagy azért, mert a OneDrive kliens nem volt bejelentkezve a rollout időpontjában, vagy azért, mert a Files On-Demand kikapcsolt állapotban volt és a tárhely elfogyott.

A KFM NEM irányítja át a Zenék, Videók, Letöltések, AppData vagy Kedvencek mappákat. Ez fontos tudás, mert néhány üzletág (pl. grafikusok, videósok) rendszeresen próbálja ide menteni a fájlokat, majd panaszkodnak, hogy nincs biztonsági mentés. Ilyenkor SharePoint dokumentumtárat vagy Azure Files megoldást kell javasolni. A támogatott OneDrive sync verziószámokat mindig ellenőrizd a hivatalos Microsoft Learn KFM dokumentációban, mert a minimum verzió évente 2-3 alkalommal módosul.

Előfeltételek ellenőrzése helpdesk oldalról

Mielőtt bármilyen szkriptet futtatnál, a helpdesk első lépése egy háromperces ellenőrzés a felhasználó gépén. A tapasztalataim szerint a KFM ticketek 60%-a itt eldől, mert valamelyik előfeltétel egyszerűen hiányzik. Az alábbi PowerShell szkript egyben lefuttatja az összes releváns diagnosztikát:

# KFM-Precheck.ps1, futtasd a felhasználó session-jében (NEM adminként)
$onedriveExe = "$env:LOCALAPPDATA\Microsoft\OneDrive\OneDrive.exe"
$version = (Get-Item $onedriveExe -ErrorAction SilentlyContinue).VersionInfo.FileVersion
Write-Host "OneDrive kliens verzió: $version"

# Bejelentkezett fiók lekérése a Registry-ből
$account = Get-ItemProperty -Path "HKCU:\Software\Microsoft\OneDrive\Accounts\Business1" -ErrorAction SilentlyContinue
Write-Host "Business fiók email: $($account.UserEmail)"
Write-Host "Tenant ID: $($account.ConfiguredTenantId)"

# KFM állapot lekérdezése
$kfmState = Get-ItemProperty -Path "HKCU:\Software\Microsoft\OneDrive\Accounts\Business1" -Name "KfmFoldersProtectedNow" -ErrorAction SilentlyContinue
Write-Host "Védett mappák bitmask: $($kfmState.KfmFoldersProtectedNow)"
# Értékek: 1=Desktop, 2=Documents, 4=Pictures, 7=mindhárom

# Aktuális Desktop és Documents útvonal
$shellFolders = Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders"
Write-Host "Desktop útvonal: $($shellFolders.Desktop)"
Write-Host "Personal (Documents): $($shellFolders.Personal)"
Write-Host "My Pictures: $($shellFolders.'My Pictures')"

Ha a KfmFoldersProtectedNow értéke 7, akkor mindhárom mappa védve van, ez az ideális állapot. Ha 0 vagy hiányzik, a felhasználó még nem futtatta le a KFM-et. A tenant azonosítót érdemes összevetni a Microsoft 365 admin center portálon látott értékkel; egyetlen karakter eltérés esetén a csendes átirányítás némán elbukik és nem ad hibaüzenetet.

A OneDrive kliens minimum verziója 2026 szeptemberében 23.106.0525.0002. Ennél régebbi kliens esetén a csendes opt-in vagy nem működik, vagy megjelenít egy interaktív toast értesítést, amit a felhasználók 78%-a bezár olvasás nélkül. Ha a GPO-oldalon akadsz el, ránézhetsz a mi csoportházirend hibaelhárítási útmutatónkra, mert a KFM GPO problémák ugyanazon gyökér-okokra vezethetők vissza.

Csendes átirányítás GPO-val: a working config

A klasszikus AD-alapú környezetekben a KFM-et a OneDrive ADMX sablonokkal állítjuk be. Az ADMX fájlokat a OneDrive telepítő automatikusan lerakja a %localappdata%\Microsoft\OneDrive\BuildNumber\adm mappába; ezeket a Central Store-ba (\\domain\SYSVOL\domain\Policies\PolicyDefinitions) kell másolnod, hogy minden DC-n elérhetők legyenek. Egy gyakori hiba, hogy a helpdesk csak az .admx fájlt másolja át és a nyelvi .adml-t nem. Ilyenkor a GPMC-ben üresek lesznek a leírások és a beállítások nem jelennek meg magyarul.

A csendes átirányításhoz három beállítást kell konfigurálnod User Configuration → Policies → Administrative Templates → OneDrive alatt:

Silently sign in users to the OneDrive sync app with their Windows credentials: Enabled. Ez engedélyezi az SSO alapú bejelentkezést az Entra ID join-olt gépeken.
Silently move Windows known folders to OneDrive: Enabled. Add meg a tenant azonosítót és opcionálisan a „Show notification to users after folders have been redirected" opciót (én ezt bekapcsolva hagyom, hogy a felhasználó tudjon róla).
Prompt users to move Windows known folders to OneDrive: ezt csak akkor kapcsold be, ha nem használod a csendes verziót. Kettő egyszerre nem barátságos, összeakad.

A tenant ID formátuma: d92e7ba5-a86c-4c3f-b3ff-4d5e6f7a8b9c, azaz 32 hexadecimális karakter kötőjelekkel elválasztva. Ha a KFMSilentOptInWithNotification beállításban ez elgépelésre kerül (pl. egy 'l' helyett '1'), a policy némán érvénytelenné válik. A validáláshoz futtasd a következőt a kliens gépen:

# GPO által kitolt tenant ID validálása
$policyTenant = (Get-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Microsoft\OneDrive" `
    -Name "KFMSilentOptIn" -ErrorAction SilentlyContinue).KFMSilentOptIn

$actualTenant = (Get-ItemProperty -Path "HKCU:\Software\Microsoft\OneDrive\Accounts\Business1" `
    -Name "ConfiguredTenantId").ConfiguredTenantId

if ($policyTenant -eq $actualTenant) {
    Write-Host "OK: Tenant ID egyezik ($policyTenant)" -ForegroundColor Green
} else {
    Write-Host "HIBA: Policy tenant=$policyTenant, Actual tenant=$actualTenant" -ForegroundColor Red
}

KFM konfiguráció Intune Administrative Templates alatt

A modern, felhő-natív környezetekben, tehát ahol a gépek Entra Join vagy Hybrid Join-oltak és Intune-nal menedzseltek, a KFM-et Configuration Profile-lal állítjuk be. Az Intune Administrative Templates 2024 óta hivatalosan tartalmazza az összes OneDrive ADMX beállítást, tehát nincs szükség Custom OMA-URI-ra vagy PowerShell scriptre.

Lépések Intune admin center-ben (intune.microsoft.com):

Devices → Configuration → Create → New Policy.
Platform: Windows 10 and later, Profile type: Templates → Administrative Templates.
A keresőbe írd: „silently move" és kattints a „Silently move Windows known folders to OneDrive" beállításra.
Enabled, add meg a tenant azonosítót, és állítsd be a „Show notification" opciót.
Rendeld hozzá az adott felhasználói csoporthoz (én mindig user assignment-et használok, nem device-t, mert a KFM felhasználó-szintű).

Intune esetén a policy alkalmazása 8 órán belül automatikus, de sürgős esetben a felhasználó gépén futtathatod: dsregcmd /refreshprt majd az Intune Company Portal alkalmazásban „Check status" gomb. Ha az Intune Administrative Templates részben nem találod a OneDrive beállításokat, ellenőrizd, hogy a tenant Intune licensz szintje P1 vagy P2. Az alap Business Premium már tartalmazza.

Az Intune-alapú konfigurációról részletes hibaelhárítást találsz a Microsoft Learn Intune Administrative Templates dokumentációjában, amely 2026 augusztusában frissült a Windows 11 24H2 kompatibilitási megjegyzésekkel.

Eltűnt asztali ikonok és parancsikonok javítása

A leggyakoribb és leghangosabb helpdesk ticket KFM rollout után: „Eltűntek az asztali ikonjaim!" A helyzet valójában az, hogy az ikonok nem tűntek el, csak a régi C:\Users\username\Desktop mappa üres lett, mert a Windows Explorer most a C:\Users\username\OneDrive - Cégnév\Desktop útvonalra mutat. A fájlok ott vannak, csak a Windows Explorer az új helyet mutatja.

A probléma akkor válik igazi problémává, amikor a parancsikonok (.lnk fájlok) törött hivatkozásokat tartalmaznak. Ez főleg akkor fordul elő, ha a KFM során a rendszer nem tudott átmigrálni néhány fájlt (túl hosszú útvonal, tiltott karakter, zárolt fájl), és ezek a régi Desktopon maradtak, miközben a parancsikonok az újba mutatnak. Én is pont ezt láttam egy budapesti pénzügyi ügyfélnél, ahol egy 260 karakteres útvonalú Excel táblázat blokkolta az egész átirányítást. A helyreállító szkriptem így néz ki:

# Fix-DesktopShortcuts.ps1: javítja a törött LNK fájlokat KFM után
$oldDesktop = "$env:USERPROFILE\Desktop"
$newDesktop = (Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders").Desktop
$newDesktop = [Environment]::ExpandEnvironmentVariables($newDesktop)

Write-Host "Régi Desktop: $oldDesktop"
Write-Host "Új Desktop: $newDesktop"

$shell = New-Object -ComObject WScript.Shell
Get-ChildItem -Path $newDesktop -Filter *.lnk | ForEach-Object {
    $shortcut = $shell.CreateShortcut($_.FullName)
    if ($shortcut.TargetPath -like "$oldDesktop\*") {
        $newTarget = $shortcut.TargetPath.Replace($oldDesktop, $newDesktop)
        if (Test-Path $newTarget) {
            $shortcut.TargetPath = $newTarget
            $shortcut.Save()
            Write-Host "Javítva: $($_.Name) -> $newTarget" -ForegroundColor Green
        } else {
            Write-Host "TÖRÖTT: $($_.Name) céljának $newTarget nem létezik" -ForegroundColor Yellow
        }
    }
}

Gyakori OneDrive KFM hibakódok és értelmezésük

Az alábbi táblázat összefoglalja a top hibakódokat, amikkel a helpdesk munkatárs KFM ticketek során találkozni fog. A hibakódot a OneDrive Activity Center-ben (jobb alsó sarok, felhő ikon) vagy a %localappdata%\Microsoft\OneDrive\logs\Business1\SyncEngine-*.odl logokból lehet kinyerni.

Hibakód	Jelentés	Gyors javítás
0x8004de40	Auth token lejárt vagy Conditional Access blokkol	OneDrive Kilépés, majd Bejelentkezés újra; ellenőrizd a CA policy-t
0x8004de85	Tenant mismatch, a felhasználó fiókja nem egyezik a GPO-ban megadott tenant ID-vel	Ellenőrizd a `KFMSilentOptIn` registry értéket a felhasználó tenant ID-jével szemben
0x8007016A	Files On-Demand kikapcsolt állapotban, de a fájl csak felhőben van	OneDrive Beállítások, Files On-Demand bekapcsolása
0x80070005	Access Denied, általában NTFS engedély vagy AV karantén	`icacls` ellenőrzés a Desktop/Documents mappán
0x80040c81	A cél mappa már át van irányítva egy másik helyre (pl. hálózati meghajtó)	Manuálisan állítsd vissza a helyi útvonalat, majd újra KFM
0x80070522	A kliensnek nincs elég jogosultsága módosítani a User Shell Folders kulcsot	UAC ellenőrzés, majd OneDrive újraindítás

A 0x8004de85 (tenant mismatch) különösen csábító hibakód, mert azonnal elárulja a gyökér-okot. Ha egy tenant-to-tenant migráció után látjátok ezt tömegesen, akkor a régi tenant ID maradt bent a GPO-ban vagy Intune profilban. Én már láttam olyan esetet is, hogy a KFMSilentOptIn a régi tenanttal, a bejelentkezett fiók viszont az újjal futott. Ilyenkor 100% biztos, hogy senki nem fog átirányítani.

Hogyan lehet visszavonni a KFM átirányítást biztonságosan

Néha vissza kell csinálni a KFM-et, például egy tenant migráció során, vagy amikor egy VIP felhasználó nem tudja elviselni a Files On-Demand villanó felhő ikonokat az asztalán. A visszavonás kritikus pontja: a fájlok NEM másolódnak vissza automatikusan a helyi Desktop mappába. Ha csak egyszerűen kikapcsolod a KFM-et, a felhasználó asztala üres lesz, és pánik ticketet kapsz 30 másodpercen belül. Én ezt egyszer megtapasztaltam éjszakai maintenance ablakban, azóta duplán ellenőrzöm a másolási lépést.

A biztonságos visszavonás sorrendje:

Kapcsold ki a GPO-t vagy Intune policy-t, de várj 1-2 sync ciklust, amíg a kliens megkapja.
OneDrive Beállítások → Sync és backup → Manage backup → Stop backup (Desktop, Documents, Pictures egyenként).
OneDrive megkérdezi, hogy „Mi legyen a fájlokkal?", válaszd az „Open folder" gombot, hogy lásd, hol vannak.
Kézzel másold vissza a fájlokat a C:\Users\username\OneDrive - Cégnév\Desktop mappából a C:\Users\username\Desktop mappába (robocopy ajánlott).
Frissítsd a User Shell Folders regisztrációs bejegyzést, hogy a Desktop értéke újra %USERPROFILE%\Desktop legyen.

# Undo-KFM.ps1: biztonságos KFM visszavonás egy felhasználón
$user = $env:USERNAME
$onedriveDesktop = "$env:OneDriveCommercial\Desktop"
$localDesktop = "$env:USERPROFILE\Desktop"

if (Test-Path $onedriveDesktop) {
    Write-Host "Fájlok másolása: $onedriveDesktop -> $localDesktop"
    robocopy $onedriveDesktop $localDesktop /E /COPY:DAT /R:2 /W:5 /LOG:"$env:TEMP\kfm-undo.log"

    # Shell Folders visszaállítása
    Set-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders" `
        -Name "Desktop" -Value "%USERPROFILE%\Desktop" -Type ExpandString
    Set-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" `
        -Name "Desktop" -Value "$localDesktop"

    Write-Host "KFM visszavonva. Kérlek jelentkezz ki és be újra." -ForegroundColor Green
} else {
    Write-Host "Nincs OneDrive Desktop mappa, nem szükséges visszavonás." -ForegroundColor Yellow
}

Event Viewer és Diagnostic Logs használata

Ha az eddigi lépések után is szinkronizálási furcsaság maradt, itt az ideje a mélyebb diagnosztikának. A OneDrive három helyen ír logokat, mindet érdemes ismerni:

Event Viewer: Applications and Services Logs → Microsoft → OneDrive. Itt látszanak a session indítás, auth és sync engine indulás eseményei.
ODL fájlok: %localappdata%\Microsoft\OneDrive\logs\Business1\, bináris formátumú, de a Microsoft OneDrive API dokumentációjában hivatkozott open-source parser (odl.py) tudja olvasni.
Activity Center: jobb klikk a OneDrive tálca ikonra, majd View sync problems. Itt látod a legutóbbi hibákat felhasználó-barát üzenettel.

A gyakorlatban a helpdesk-nek elég az Activity Center és az Event Viewer. Az ODL fájlokat általában eskalációra küldjük Microsoft supportnak, mert ott van benne minden HTTP request/response headerrel együtt. Ha a felhasználónál gyakori 0x8004de40 auth hiba jön elő, először a mi Microsoft 365 MFA kizárás útmutatónkat érdemes átfutni, mert gyakran ott van a gyökér-ok. Ha a felhasználó nem is tud a Outlookon bejelentkezni, akkor pedig az Outlook csatlakozási hibáit tárgyaló cikkünk is segíthet a Conditional Access nyomozásban.

Ha a szinkronizálás valóban beragadt egy fájlon (pl. Excel megnyitva egy másik gépen), akkor a OneDrive kliens újraindítása segít: taskkill /f /im onedrive.exe, majd Start-Process "$env:LOCALAPPDATA\Microsoft\OneDrive\OneDrive.exe" -ArgumentList "/background". Ha ez sem elég, egy „reset" is működik: %localappdata%\Microsoft\OneDrive\onedrive.exe /reset. Ez törli a sync cache-t, de a felhőbeli fájlokat NEM érinti. Reset után a kliens újra letölti a Files On-Demand indexet, ami nagy Documents mappánál akár 20-30 percig is eltarthat.

Ismert korlátok és 2026-os változások

A 2026 tavaszi OneDrive kliens frissítéssel (verzió 23.86 és későbbiek) néhány dolog változott, amit érdemes tudnod:

A Files On-Demand alapértelmezésben BE van kapcsolva. A régi „always available" letöltés kikapcsolásához Storage Sense policy kell.
A hosszú útvonal (Long Path) limit 400 karakter, előtte 260 volt. Ez enyhíti a régi „path too long" migrációs hibákat, de nem oldja meg teljesen.
A KFM most már támogatja az OneDrive Personal + Business egyidejű bejelentkezést, de mindig csak Business1-ből lehet KFM-et csinálni.
Az új OneDrive Health Dashboard az M365 admin centerben megmutatja tenant szintjén, hány gépen sikerült vagy bukott meg a KFM opt-in. Ezt havonta érdemes review-zni.

Egy fontos, gyakran figyelmen kívül hagyott korlát: a KFM nem működik domain-joined-only gépeken, ha nincs Entra Hybrid Join. Ha a szervezet még klasszikus AD-t használ Entra Connect nélkül, akkor a felhasználónak minden gépen kézzel kell bejelentkeznie a OneDrive-ba, és a csendes opt-in nem lép életbe. Ez egy tipikus 2019 előtti hibrid setup, amit még mindig sok kisközépes cégnél látunk.

Gyakran ismételt kérdések

Mit jelent az Ismert mappák áthelyezése (KFM) a OneDrive-ban?

A KFM egy OneDrive funkció, amely automatikusan átirányítja az Asztal, Dokumentumok és Képek Windows mappákat a felhasználó OneDrive szinkronizálási könyvtárába. A célja, hogy a felhasználói fájlok eszközcsere vagy meghibásodás esetén se vesszenek el, és minden Windows gépen ugyanaz a tartalom jelenjen meg.

Miért nem szinkronizál az OneDrive az Asztallal a KFM bekapcsolása után?

A leggyakoribb ok a tenant ID elírása a GPO-ban vagy Intune policy-ban, illetve az elavult OneDrive kliens verzió. Ellenőrizd a KFMSilentOptIn registry kulcsot és a ConfiguredTenantId értékét, ezeknek karakterre pontosan egyezniük kell. Ha eltérnek, a KFM némán elbukik hibaüzenet nélkül.

Hogyan visszavonom az Ismert mappák áthelyezését?

OneDrive Beállítások, Sync és backup, Manage backup menüben mindhárom mappát „Stop backup" opcióval kikapcsolhatod. FONTOS: a fájlokat kézzel kell visszamásolnod a helyi Desktop mappába, a OneDrive nem másolja vissza automatikusan. Használj robocopy szkriptet a biztonságos átmozgatáshoz.

Mit tegyek, ha eltűntek az asztali ikonok az OneDrive KFM után?

Az ikonok valójában nem tűntek el, a Windows Explorer most az új útvonalra mutat: C:\Users\username\OneDrive - Cégnév\Desktop. Ha ott sincsenek, ellenőrizd az Activity Center-t szinkronizálási hibákra, vagy futtasd a cikkben bemutatott Fix-DesktopShortcuts.ps1 szkriptet a törött parancsikonok javítására.

Támogatja a KFM a Zenék és Letöltések mappákat is?

Nem, 2026-ban a KFM CSAK az Asztal, Dokumentumok és Képek mappákat támogatja. A Zenék, Videók, Letöltések, Kedvencek és AppData mappák nem irányíthatók át. Ha ezekre is kell biztonsági mentés, SharePoint dokumentumtár, Azure Files vagy külön backup megoldás (pl. Veeam Endpoint) javasolt.

Milyen OneDrive kliens verzió kell a csendes KFM-hez 2026-ban?

A minimum támogatott verzió 2026 szeptemberében 23.106.0525.0002. Régebbi klienseken vagy nem működik a csendes átirányítás, vagy interaktív toast értesítést jelenít meg, amit a felhasználók zöme bezár. Az aktuális minimum verziót mindig ellenőrizd a Microsoft Learn KFM dokumentációjában, mert évente többször frissül.