Orientações de migração do OneNote para Windows 10
Artigo
Importante
O OneNote para Windows 10 atingirá o fim do suporte em outubro de 2025. Os clientes empresariais devem mudar do OneNote para Windows 10 para o OneNote no Windows, que está disponível na Microsoft Store e com uma subscrição do Microsoft 365. O OneNote no Windows oferece novas funcionalidades e atualizações e permite-lhe personalizar as definições de utilizador através de Política de Grupo.
Este artigo fornece orientações para migrar a sua organização do OneNote para Windows 10 para o OneNote para Windows. Inclui instruções para identificar utilizadores, personalizar scripts de migração e garantir a integridade dos dados ao longo do processo. Encontrará passos de resolução de problemas e melhores práticas para ajudar a minimizar a interrupção e a salvaguardar os dados dos utilizadores durante a migração.
Identificar utilizadores no OneNote para Windows 10:
Para identificar utilizadores ou dispositivos na sua organização com o OneNote para Windows 10 através de Microsoft Intune, siga estes passos para executar um relatório:
No Intune, navegue para: Todas as Aplicações de Serviços>| Monitorize>>As aplicações detetadas e, em seguida, procure "Office.OneNote".
Procure a versão da aplicação que começa com 16001.xxxxx.xxxxx.x, para identificar o OneNote para Windows 10 utilizadores. A versão mais recente é 16001.14326.22094.0
Observação
O script de migração de exemplo funciona apenas com o OneNote para dispositivos Windows 10 na versão16001.14326.22094.0
Personalização do script de exemplo
Antes de executar o script de exemplo, instale o OneNote no Windows em dispositivos de utilizador se a aplicação não tiver sido instalada. Para obter mais informações, veja Guia de implementação do OneNote
Para garantir uma migração suave para o OneNote para Windows, as organizações têm de personalizar o seguinte script de exemplo para concluir estes passos por ordem:
Verifique se o OneNote para Windows 10 está instalado e se o caminho para a pasta AppData da aplicação existe (o que indica se o utilizador abriu a aplicação antes) para verificar se a migração é necessária.
Verifique se o OneNote para Windows está instalado ao verificar se o ficheiro executável existe no dispositivo.
Verifique a versão do OneNote para Windows 10 para garantir que está na versão mais recente com funcionalidades importantes para evitar a perda de dados durante a migração.
Observação
Este script não funciona para dispositivos com o OneNote para Windows 10 versões abaixo da versão 16001.14326.22094. Os administradores de TI têm de atualizar estes dispositivos de acordo com a política da organização.
Termine todos os processos do OneNote para Windows 10.
Faça uma cópia de segurança de todas as secções não sequenciadas para a pasta sandbox com o onenote-uwp://backup: comando .
Armazene as cópias de segurança no sandbox em: $localAppDataPath\Packages\Microsoft.Office.OneNote_8wekyb3d8bbwe\AppData\Local\OneNote\16.0\BackUp\.
Certifique-se de que apenas as secções com conteúdo não sincronizado são criadas em cópia de segurança e organizadas em pastas onde cada pasta corresponde a um bloco de notas.
Analise o UWPBackUpStatus.json para confirmar que a cópia de segurança foi efetuada com êxito.
Aviso
A desinstalação com uma cópia de segurança falhada pode levar à perda de dados.
Mova os ficheiros de cópia de segurança para uma localização fora do sandbox: $localAppDataPath\Packages\Microsoft.Office.OneNote_8wekyb3d8bbwe\
uma vez que o caminho do sandbox será eliminado assim que a aplicação OneNote para Windows 10 for desinstalada.
Desinstale o OneNote para Windows 10.
Certifique-se de que o OneNote para Windows 10 é desinstalado por utilizador e não por dispositivo.
Este processo ajuda a mitigar cenários em que os dispositivos partilhados têm notas não sequenciadas removidas para todas as contas.
Importante
Antes de utilizar o script de exemplo, tem de personalizá-lo para se ajustar aos requisitos específicos de implementação e migração da sua organização.
#############################################
###### OneNote for Windows 10 ############
###### External Migration Script v6 ######
#############################################
## Optional: Helper function to write logs 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"
}
## Check if OneNote for Windows 10 is installed and if the AppData path exists ##
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 "OneNote UWP app version: $uwpVersion"
}
else {
writeLogsToFileAndConsole "OneNote UWP App is not installed"
exit
}
if (Test-Path $folderPath)
{
Write-Host "OneNote UWP AppData folder detected"
}
else {
($null -ne $uwpApp)
$uwpApp | Remove-AppxPackage
writeLogsToFileAndConsole "OneNote AppData folder does not exist and OneNote UWP will now be uninstalled"
exit
}
}
## Check if OneNote for Windows is installed by checking the existence of the executable file ##
function checkOneNoteWin32Install {
$oneNotePath = Join-Path $env:ProgramFiles "Microsoft Office\root\Office16\ONENOTE.EXE"
if (Test-Path $oneNotePath) {
writeLogsToFileAndConsole "OneNote Win32 is installed"
} else {
writeLogsToFileAndConsole "OneNote Win32 is not installed"
exit
}
}
## Check version of the user's OneNote for Windows 10 app ##
function checkUWPVersion {
$uwpApp = Get-AppxPackage | Where-Object {$_.Name -eq "Microsoft.Office.OneNote"}
if ($null -ne $uwpApp)
{
$uwpVersion = $uwpApp.Version
$uwpVersionObject = [System.Version]$uwpVersion
$updatedVersion = "16001.14326.22094.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
}
}
## Terminate 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"
}
}
## Run the protocol to back up unsynced sections into the sandbox path ##
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"
}
## Parse 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
}
}
## Copy the backup files to a directory outside of the sandbox path ##
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"
}
## Uninstall the OneNote for Windows 10 app ##
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
checkUWPVersion
killProcess
launchBackUp
parseJson
moveBackup
uninstallUWP
}
## Executes the main routine ##
MainRoutine
Aceder a notas migradas
Após a migração, os utilizadores podem obter as suas notas ao:
Abrir a nova aplicação OneNote no Windows .
Iniciar sessão na conta.
Abrir os respetivos blocos de notas.
Se existirem notas em falta, marcar a pasta de cópia de segurança que foi criada nos passos anteriores.
Para rever as cópias de segurança através do OneNote no Windows:
Navegue para Ficheiro –> Abrir Cópias de Segurança –> navegue para o caminho do ficheiro de cópia de segurança.
Solução de problemas
Reveja os UWPBackupStatus.json ficheiros e UWPSyncStatus.json na pasta de cópia de segurança do utilizador para obter informações detalhadas sobre os estados de cópia de segurança e sincronização.
Para erros encontrados durante a migração, veja o ficheiro de registo localizado na cópia de segurança gerada anteriormente (passo 1.d).
Se o onenote-uwp://backup: comando falhar:
Certifique-se de que a aplicação OneNote para Windows 10 é a aplicação predefinida associada ao onenote-uwp protocolo.
Consulte o artigo de suporte relevante para garantir que o anexo de protocolo correto para o OneNote Windows 10.
Cuidado
Tenha cuidado ao utilizar comandos encontrados online. Teste sempre comandos num ambiente controlado antes de os implementar em toda a organização para evitar consequências inesperadas, como as resultantes do comando Remove-AppxPackage.
Para obter mais assistência ou consultas, contacte Suporte da Microsoft.
Planeje e execute uma estratégia de implantação de ponto de extremidade, usando elementos essenciais de gerenciamento moderno, abordagens de cogerenciamento e integração com o Microsoft Intune.