Windows 10 마이그레이션 지침용 OneNote

아티클
11/09/2024

중요

Windows 10 OneNote는 2025년 10월에 지원이 종료됩니다. 엔터프라이즈 고객은 Microsoft Store 및 Microsoft 365 구독에서 사용할 수 있는 Windows의 OneNote로 Windows 10 OneNote에서 전환해야 합니다. Windows의 OneNote는 새로운 기능과 업데이트를 제공하며 그룹 정책 통해 사용자 설정을 사용자 지정할 수 있습니다.

이 문서에서는 Windows 10 OneNote에서 Windows용 OneNote로 organization 마이그레이션하기 위한 지침을 제공합니다. 여기에는 사용자를 식별하고, 마이그레이션 스크립트를 사용자 지정하고, 프로세스 전체에서 데이터 무결성을 보장하기 위한 지침이 포함되어 있습니다. 마이그레이션 중에 중단을 최소화하고 사용자 데이터를 보호하는 데 도움이 되는 문제 해결 단계 및 모범 사례를 찾을 수 있습니다.

Windows 10 OneNote에서 사용자 식별:

Microsoft Intune 통해 Windows 10 OneNote를 사용하여 organization 사용자 또는 디바이스를 식별하려면 다음 단계에 따라 보고서를 실행합니다.

Intune 모든 서비스> 앱 | 로 이동합니다. 검색된 앱모니터>>, "Office.OneNote"를 검색합니다.
부터 시작하는 16001.xxxxx.xxxxx.x애플리케이션 버전을 찾아 Windows 10 사용자에 대한 OneNote를 식별합니다. 최신 버전은 16001.14326.22094.0

참고

샘플 마이그레이션 스크립트는 버전의 Windows 10 디바이스에 대한 OneNote에서만 작동합니다.16001.14326.22094.0

샘플 스크립트 사용자 지정

Windows용 OneNote로 원활하게 마이그레이션하려면 조직에서 다음 샘플 스크립트를 사용자 지정하여 이러한 기능을 완료해야 합니다.

사용자 디바이스에서 Windows에 OneNote를 설치합니다. 자세한 내용은 OneNote 배포 가이드를 참조하세요.
중요한 기능을 통합하고 동기화되지 않은 노트를 마이그레이션하는 동안 데이터 손실을 방지하기 위해 최신 빌드에 Windows 10 OneNote를 업데이트.

참고

이 스크립트는 버전 16001.14326.22094에 없는 Windows 10 디바이스에 대해 OneNote를 업데이트하지 않습니다. IT 관리자는 organization 정책에 따라 이러한 디바이스를 업그레이드해야 합니다.
Windows 10 프로세스에 대한 모든 OneNote를 종료합니다.
명령을 사용하여 동기화되지 않은 전자 필기장을 사용자의 백업 폴더에 onenote-uwp://backup: 백업합니다.
- 백업은 에 C:\temp\OneNoteMigration저장되지만 organization 요구에 맞게 경로를 자유롭게 편집할 수 있습니다.
- 각 백업은 이 경로 내에서 동기화되지 않은 섹션이 있는 각 Notebook에 해당하는 폴더를 만듭니다.
을 UWPBackUpStatus.json 구문 분석하여 백업이 성공했는지 확인합니다.
- 실패한 백업으로 제거하면 데이터가 손실될 수 있습니다.
  
  참고
  
  백업을 수행하려면 Windows용 OneNote를 설치해야 하며 Windows 10 OneNote를 버전 16001.14326.22094 이상으로 업데이트해야 합니다.
Windows 10 OneNote를 제거합니다.
- Windows 10 OneNote가 디바이스 기반이 아닌 사용자별로 제거되었는지 확인합니다. 이 프로세스는 공유 디바이스가 모든 계정에 대해 동기화되지 않은 노트를 제거하는 시나리오를 완화하는 데 도움이 됩니다.

중요

샘플 스크립트를 사용하기 전에 organization 특정 배포 및 마이그레이션 요구 사항에 맞게 사용자 지정해야 합니다.

#############################################
######   OneNote for Windows 10  ############
######   External Migration Script v5  ######
#############################################

## Creates backupFolder and writes log from script to UWPMigrationResult.log File and Console ##

function writeLogsToFileAndConsole {
    Param ([string]$logstring)
    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    $logstringWithTimestamp = "[$timestamp] $logstring"
    $backupFolder = [System.Environment]::GetFolderPath('LocalApplicationData') + "\Microsoft\OneNote\16.0\Backup"
    $outputFile = $backupFolder + "\UWPMigrationResult.log"

    if (-not (Test-Path $backupFolder)) {
        New-Item -Path $backupFolder -ItemType Directory
    }

    if (-not (Test-Path $outputFile)) {
        New-Item -Path $outputFile -ItemType File
    }

    Add-content $outputFile -value "$logstringWithTimestamp"
    Write-Host "$logstringWithTimestamp"
}

## Checks if OneNote UWP is installed and if app data exists, writes version to log file and console ##

function checkOneNoteUWPInstall {
    $folderPath = "$env:LOCALAPPDATA\Packages\Microsoft.Office.OneNote_8wekyb3d8bbwe\LocalState\AppData\Local\OneNote"
    $uwpApp = Get-AppxPackage | Where-Object {$_.Name -eq "Microsoft.Office.OneNote"}
    if ($null -ne $uwpApp) {
    $uwpVersion = $uwpApp.Version
    $uwpVersionObject = [System.Version]$uwpVersion
        writeLogsToFileAndConsole "UWP OneNote app version: $uwpVersion"
    } else {
        writeLogsToFileAndConsole "OneNote UWP App is not installed"
    exit
    }

    if (Test-Path $folderPath) {
        Write-Host "AppData folder detected"
    } else {
        ($null -ne $uwpApp) 
        $uwpApp | Remove-AppxPackage
        writeLogsToFileAndConsole "AppData folder does not exist and OneNote UWP will now be uninstalled"
    exit
    }
}

## Checks if OneNote Win32 is installed by checking the existence of the executable file and checks the version ##

function checkOneNoteWin32Install {
    $oneNotePath = Join-Path $env:ProgramFiles "Microsoft Office\root\Office16\ONENOTE.EXE"
    $registryPath = "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration"
    $versionValueName = "ClientVersionToReport"
    $registry = Get-ItemProperty -Path $registryPath
    
    if (Test-Path $oneNotePath) {
        if ($registry.PSObject.Properties[$versionValueName]) {
            $versionValue = $registry.$versionValueName
            writeLogsToFileAndConsole "OneNote Win32 Version Value: $versionValue is installed at path $oneNotePath"   
    } else {
        writeLogsToFileAndConsole "OneNote Win32 is not installed"
        exit
    }
 }   

## Checks for backup folder path
  
    $registryPath = "HKCU:\SOFTWARE\Microsoft\Office\16.0\OneNote\Options\Paths"
    $backupValueName = "BackupFolderPath"
    if (Test-Path $registryPath) {
        $registry = Get-ItemProperty -Path $registryPath
        if ($registry.PSObject.Properties[$backupValueName]) {
            $backupValue = $registry.$backupValueName
            writeLogsToFileAndConsole "OneNote Win32 Backup Path Value: $backupValue"
        }
    }
}

## Updates OneNote for Windows 10 to the latest version available ##

function updateUWPVersion {
    $uwpApp = Get-AppxPackage | Where-Object {$_.Name -eq "Microsoft.Office.OneNote"}
    if ($null -ne $uwpApp) {
        $uwpVersion = $uwpApp.Version
        $uwpVersionObject = [System.Version]$uwpVersion

        $updatedVersion = "16001.14326.22008.0"
        $updatedVersionObject = [System.Version]$updatedVersion

        $unsupportedVersion = "16001.14327.10000.0"
        $unsupportedVersionObject = [System.Version]$unsupportedVersion

    if ($uwpVersionObject -ge $unsupportedVersionObject)
        {
        writeLogsToFileAndConsole "Unsupported version of OneNote UWP app. Please check the Microsoft Store for updates"
            exit
    }

    if ($uwpVersionObject -lt $updatedVersionObject)
        {
            writeLogsToFileAndConsole "You must upgrade OneNote UWP to a version higher than 16.0.14326.21802. Please check the Microsoft Store"
            exit
        }
    else
        {
            writeLogsToFileAndConsole "OneNote UWP will backup and uninstall"
        }
    }
    else
    {
        writeLogsToFileAndConsole "No OneNote UWP detected therefore no need for migration"
        exit
    }
}
## Terminates the OneNote for Windows 10 app before executing the rest of the migration script ##

function killProcess {
    if (Get-Process -Name "OneNoteIm" -ErrorAction SilentlyContinue)
    {
        try
        {
            $uwpProcess = Get-Process -Name "OneNoteIm"
            Stop-Process -Id $uwpProcess.Id -Force
            Start-Sleep -Seconds 10
        }
        catch
        {
            writeLogsToFileAndConsole "An error occurred when killing the current OneNote UWP process: $($_.Exception.GetType().FullName)"
            writeLogsToFileAndConsole "$($_.Exception.Message)"
            exit
        }

        writeLogsToFileAndConsole "OneNote UWP process killed"
    }
}

function launchBackUp {
    try
    {
        Start-Process "onenote-uwp://backup:"
        Start-Sleep -Seconds 60
        writeLogsToFileAndConsole "OneNote UWP backup initiated"
    }
    catch
    {
        writeLogsToFileAndConsole "An error occurred when starting the backup: $($_.Exception.GetType().FullName)"
        writeLogsToFileAndConsole "$($_.Exception.Message)"
        exit
    }

    writeLogsToFileAndConsole "OneNote UWP backup in progress"
}

## Parses the results in the json files to validate that the backup was successful ##

 function parseJson {
    try
    {
        $localAppDataPath = [System.Environment]::GetFolderPath('LocalApplicationData')
        $jsonPath = "$localAppDataPath\Packages\Microsoft.Office.OneNote_8wekyb3d8bbwe\LocalState\AppData\Local\OneNote\16.0\UWPBackUpStatus.json"
        if(!(test-path $jsonPath)){
            writeLogsToFileAndConsole "Backup Json file path is not valid"
            exit
        }
        $backupJsonFileContent = Get-Content -Path $jsonPath -Raw | ConvertFrom-Json
        $status = $backupJsonFileContent."UWP Backup Status"
        if ($status -eq "Completed") {
            $jsonPath2 = "$localAppDataPath\Packages\Microsoft.Office.OneNote_8wekyb3d8bbwe\LocalState\AppData\Local\OneNote\16.0\UWPSyncStatus.json"
            if(test-path $jsonPath2)
            {
            $syncStatusJsonContent = Get-Content -Raw -Path $jsonPath2
            $syncStatusJsonObject = COnvertFrom-Json $syncStatusJsonContent
            foreach ($key in $syncStatusJsonObject.PSObject.Properties)
            {
                $value = $syncStatusJsonObject.$($key.Name)
                if ($value.StartsWith("Contains pending outbounding changes: true,"))
                {
                    if ($backupJsonFileContent."Number of sections Backed up" -eq 0)
                    {
                        writeLogsToFileAndConsole "No error occurred when backing up but outbounding changes were not backed up successfully"
                        exit
                    }
                    else
                    {
                        break
                    }
                }
            }
        }

            writeLogsToFileAndConsole "OneNote UWP backup is completed and status is saved"
        }
        elseif ($status -eq "")
        {
            writeLogsToFileAndConsole "$status"
            writeLogsToFileAndConsole "No error occurred but backup did not finish. We cannot continue migration. Consider increasing the Start-Sleep time in line 130 and rerun the script"
            exit
        }
        else
        {
            writeLogsToFileAndConsole "No error occurred but backup status is $status. We cannot continue migration. Consider increasing the Start-Sleep time in line 130 and rerun the script"
            exit
        }
    }
    catch
    {
        writeLogsToFileAndConsole "An error occurred when finishing the backup: $($_.Exception.GetType().FullName)"
        writeLogsToFileAndConsole "$($_.Exception.Message)"
        exit
    }
}

## Copies the backup files to the local app data folder ##

 function moveBackup {
    try
    {
        $localAppDataPath = [System.Environment]::GetFolderPath('LocalApplicationData')
        $sourcePath = "$localAppDataPath\Packages\Microsoft.Office.OneNote_8wekyb3d8bbwe\LocalState\AppData\Local\OneNote\16.0\BackUp\"
        $destinationPath = [System.Environment]::GetFolderPath('LocalApplicationData') + "\Microsoft\OneNote\16.0\Backup\"

        Copy-Item -Path $sourcePath\* -Destination $destinationPath -Recurse -Force

        $sourcePath = "$localAppDataPath\Packages\Microsoft.Office.OneNote_8wekyb3d8bbwe\LocalState\AppData\Local\OneNote\16.0"
        $fileExtensions = "*.json", "*.txt"
        foreach ($fileExtension in $fileExtensions)
        {
            $files = Get-ChildItem -Path $sourcePath -Filter $fileExtension
            foreach ($file in $files) {
                Copy-Item -Path $file.FullName -Destination $destinationPath -Force
            }
        }
    }
    catch
    {
        writeLogsToFileAndConsole "An error occurred when moving the backup files: $($_.Exception.GetType().FullName)"
        writeLogsToFileAndConsole "$($_.Exception.Message)"
        exit
    }

    writeLogsToFileAndConsole "Backup files copied successfully from $sourcePath to $destinationPath"
 }

function uninstallUWP {
    $uwpApp = Get-AppxPackage | Where-Object {$_.Name -eq "Microsoft.Office.OneNote"}
    if ($null -ne $uwpApp) {
        $uwpApp | Remove-AppxPackage
        writeLogsToFileAndConsole "OneNote UWP version uninstalled"
    }
}

function MainRoutine {
    checkOneNoteWin32Install
    checkOneNoteUWPInstall
    updateUWPVersion
    launchBackUp
    killProcess
    parseJson
    moveBackup
    uninstallUWP
}

## Executes the main routine ##

MainRoutine

마이그레이션된 노트 액세스

마이그레이션 후 사용자는 다음을 통해 노트를 검색할 수 있습니다.

Windows에서 새 OneNote 애플리케이션을 엽니다.
계정에 로그인합니다.
전자 필기장을 엽니다.

메모가 누락된 경우 이전 단계에서 만든 백업 폴더를 검사.

Windows에서 OneNote를 통해 백업을 검토하려면 다음을 수행합니다.

파일 -> 백업 열기 -> 백업 파일 경로로 이동합니다.

문제 해결

UWPBackupStatus.json 백업 및 동기화 상태에 대한 자세한 내용은 사용자의 백업 폴더에 있는 및 UWPSyncStatus.json 파일을 검토합니다.
마이그레이션 중에 발생한 오류는 이전에 생성된 백업에 있는 로그 파일(1.d단계)을 참조하세요.

명령이 실패하는 onenote-uwp://backup: 경우:

Windows 10 앱용 OneNote가 프로토콜에 연결된 onenote-uwp 기본 앱인지 확인합니다.
Windows 10 OneNote에 대한 올바른 프로토콜 첨부 파일을 확인하려면 관련 지원 문서를 참조하세요.

주의

온라인에서 찾은 명령을 사용할 때는 주의해야 합니다. 항상 제어된 환경에서 명령을 배포하기 전에 organization 전체에서 명령을 테스트하여 Remove-AppxPackage 명령으로 인한 의도하지 않은 결과를 방지합니다.

추가 지원 또는 문의는 Microsoft 지원 문의하세요.

다음을 통해 공유

Windows 10 마이그레이션 지침용 OneNote

Windows 10 OneNote에서 사용자 식별:

샘플 스크립트 사용자 지정

마이그레이션된 노트 액세스

문제 해결

피드백

추가 리소스

다음을 통해 공유

Windows 10 마이그레이션 지침용 OneNote

Windows 10 OneNote에서 사용자 식별:

샘플 스크립트 사용자 지정

마이그레이션된 노트 액세스

문제 해결

관련 문서

피드백

추가 리소스