Guia de implementação do OneNote
Importante
O oneNote para Windows 10 atingirá o fim do suporte em outubro de 2025. Recomenda-se que todos os clientes empresariais mudem 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 da Política de Grupo.
O OneNote está incluído juntamente com outras aplicações do Office, como o Word, Excel e PowerPoint, quando implementa o Microsoft 365 Apps, o Office LTSC 2021 ou o Office 2019. Não existem outros passos que precise de seguir para incluir o OneNote com novas instalações do Office. No entanto, certifique-se sempre de que verifica as definições de implementação antes de implementar, por exemplo, quando utilizar os assistentes no Configuration Manager (ramo atual) ou no Microsoft Intune.
Utilize a Ferramenta de Implementação do Office ou o software de implementação empresarial, como o Microsoft Configuration Manager, para incluir ou excluir o OneNote quando implementar o Office na sua organização.
Para adicionar o OneNote a uma instalação existente do Office
Se instalar o Office no seu dispositivo, mas o OneNote estiver em falta, utilize a Ferramenta de Implementação do Office e o seguinte ficheiro configuration.xml para adicionar o OneNote.
<Configuration>
<Add>
<Product ID="OneNoteFreeRetail">
<Language ID="MatchInstalled"/>
</Product>
</Add>
</Configuration>
Quando implementa a versão gratuita do OneNote, a licença é atualizada automaticamente para corresponder à versão do Office já instalada no dispositivo assim que o utilizador abrir o OneNote pela primeira vez.
Observação
- A utilização do OneNoteFreeRetail não é suportada com versões de licenciamento em volume do Office, como o Office LTSC Professional Plus 2021 ou o Office Standard 2019. Para voltar a adicionar o OneNote a essas versões do Office, pode executar uma Reparação Online.
- Se implementar a versão freemium do OneNote, quando aceder aProgramas e Funcionalidades> do Painel> de Controlo, o OneNote será apresentado como uma entrada autónoma denominada Microsoft OneNote Casa e Estudantes 2016.
Para excluir o OneNote da instalação
Existem diferentes formas de excluir o OneNote de ser instalado com o Office, consoante o método de implementação que estiver a utilizar, conforme mostrado na tabela seguinte.
| Método | Instruções |
|---|---|
| Ferramenta de Implantação do Office | Pode utilizar o elemento ExcludeApp no ficheiro configuration.xml. Recomendamos que utilize a Ferramenta de Personalização do Office para o ajudar a criar o seu ficheiro de configuration.xml. |
| Microsoft Configuration Manager (ramo atual) | No assistente de Instalação do Cliente do Office 365, pode definir o OneNote para a posição Desativado quando configurar as definições do Office. |
| Microsoft Intune | Na página Configurar conjunto de aplicações , pode desmarcar a caixa de verificação do OneNote na lista pendente Selecionar aplicações do Office . |
No entanto, se estiver a permitir que os seus utilizadores instalem o Office a partir do portal do Office 365, não há forma de excluir o OneNote da instalação.
Orientações de migração do OneNote para Windows 10
Observação
Para garantir um serviço e um fluxo de trabalho ininterruptos, recomendamos vivamente que as organizações migrem para o OneNote no Windows bem antes da data de fim de suporte do OneNote para Windows 10, em outubro de 2025.
Esta secção fornece um guia passo a passo para o ajudar a desenvolver uma política de migração e a executar a transição sem problemas.
Desenvolvimento de Políticas de Migração: para facilitar uma migração com êxito para o OneNote no Windows, as organizações devem:
Personalizar o Script de Migração.
Utilize este script de exemplo para se adequar às necessidades da sua organização.
#############################################
###### OneNote 2024 ######################
###### Migration Script v1.6.4 ###########
#############################################
$localAppDataPath = [System.Environment]::GetFolderPath('LocalApplicationData')
$outputFile = "C:\temp\OneNoteMigration\UWPBackUpResult.log"
function writeLogsToFileAndConsole {
Param ([string]$logstring)
Add-content $outputFile -value "$logstring"
Write-Host "$logstring"
}
## Check if OneNote UWP is installed ##
function checkOneNoteUWPInstalled {
$uwpApp = Get-AppxPackage | Where-Object {$_.Name -eq "Microsoft.Office.OneNote"}
if ($null -ne $uwpApp) {
writeLogsToFileAndConsole "OneNote UWP App is installed"
}
else {
writeLogsToFileAndConsole "OneNote UWP App is not installed"
}
}
function getWin32RegKeys {
$registryPath = "HKCU:\SOFTWARE\Microsoft\Office\16.0\OneNote"
$bootValueName = "FirstBootStatus"
# check if OneNote Win32 is installed or not
try
{
Start-Process -FilePath "onenote.exe"
Stop-Process -Name "onenote"
}
catch
{
Write-Host "You must first install OneNote Win32. Please refer to the deployment guide"
exit
}
$outputDir = "C:\temp\OneNoteMigration\"
if(!(test-path $outputDir)){new-item -path "C:\temp\OneNoteMigration\" -ItemType directory -name OneNoteUWPBackup|out-null}
new-item -path $outputDir -name UWPBackupResult.log -Type File -Force
$registry = Get-ItemProperty -Path $registryPath
# get FRE status
if ($registry.PSObject.Properties[$bootValueName]) {
$bootValue = $registry.$bootValueName
writeLogsToFileAndConsole "OneNote Win32 FRE Value: $bootValue"
}
# get client version and audience data
$registryPath = "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration"
$versionValueName = "ClientVersionToReport"
$audienceValueName = "AudienceData"
$registry = Get-ItemProperty -Path $registryPath
if ($registry.PSObject.Properties[$versionValueName]) {
$versionValue = $registry.$versionValueName
writeLogsToFileAndConsole "OneNote Win32 Version Value: $versionValue"
}
if ($registry.PSObject.Properties[$audienceValueName]) {
$audienceValue = $registry.$audienceValueName
writeLogsToFileAndConsole "OneNote Win32 Audience Value: $audienceValue"
}
# get backup folder path if existed
$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"
}
}
# get uwp version
$uwpApp = Get-AppxPackage | Where-Object {$_.Name -eq "Microsoft.Office.OneNote"}
$uwpVersion = $uwpApp.Version
$uwpVersionObject = [System.Version]$uwpVersion
writeLogsToFileAndConsole "UWP OneNote app version: $uwpVersion"
}
## Update 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.21802.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 version up to date"
}
}
else
{
writeLogsToFileAndConsole "No OneNote UWP detected. 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"
}
}
function launchBackUp {
try
{
$OneNoteUWPLaunch = (Get-AppxPackage -Name Microsoft.Office.OneNote).InstallLocation + "/onenoteim.exe"
Start-Process "onenote-cmd://backup:" -filepath $OneNoteUWPLaunch
#Start-Process "onenote-cmd://backup:"## used for standard user devices ##
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 started"
}
## Parse the results in json files to read if backup was successful; if so and there were outbounding changes if files were backed up and migration can continue ##
function parseJson {
try
{
killProcess
$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 backed up sections and migration result files to the output folder path determined above ##
function moveBackup {
try
{
$localAppDataPath = [System.Environment]::GetFolderPath('LocalApplicationData')
$sourcePath = "$localAppDataPath\Packages\Microsoft.Office.OneNote_8wekyb3d8bbwe\LocalState\AppData\Local\OneNote\16.0\BackUp"
$destinationPath = "C:\temp\OneNoteMigration\"
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 {
checkOneNoteUWPInstalled
getWin32RegKeys
launchBackUp
parseJson
moveBackup
updateUWPVersion
killProcess
uninstallUWP
}
# Execute the main routine
MainRoutine
Certifique-se de que o script executa as seguintes funções:
Instala o OneNote no Windows em dispositivos de utilizador. Veja a secção Orientações de Implementação para obter mais detalhes.
Atualiza o OneNote para Windows 10 para a compilação mais recente (compilação mínima 16001.14326.21802.0) para incorporar funcionalidades essenciais que impedem a perda de dados durante a migração de notas não sequenciadas.
Termina todos os processos do OneNote para Windows 10.
Faz uma cópia de segurança de todos os blocos de notas não sincronizados para a pasta de cópia de segurança do utilizador com o
onenote-cmd://backup:comando .- No entanto, as cópias de segurança são armazenadas no
C:\temp\OneNoteMigration, pode editar o caminho de acordo com as necessidades da sua organização. - Cada cópia de segurança cria uma pasta correspondente para cada bloco de notas com secções não sincronizadas neste caminho.
- No entanto, as cópias de segurança são armazenadas no
Analisar através do
UWPBackUpStatus.jsonpara validar que a cópia de segurança foi efetuada com êxito.- A desinstalação com uma cópia de segurança falhada pode levar à perda de dados.
Desinstala o OneNote para Windows 10.
- Certifique-se de que o OneNote para Windows 10 é desinstalado por um utilizador e não numa base de dispositivo. Isto ajudará a mitigar cenários em que os dispositivos partilhados têm notas não sequenciadas removidas para todas as contas.
Aceder às 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, verifique 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.jsonficheiros eUWPSyncStatus.jsonna 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-cmd://backup: comando falhar:
- Certifique-se de que a aplicação OneNote para Windows 10 é a aplicação predefinida associada ao
onenote-cmdprotocolo. - Consulte o artigo de suporte relevante para garantir que o protocolo está correto para o OneNote para 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 assistência ou consultas adicionais, contacte o Suporte da Microsoft.
Informações adicionais sobre a implementação do OneNote
Recursos de formação do OneNote Estamos a fornecer eBooks gratuitos e partilháveis para ajudar os seus utilizadores a transitar para a interface de utilizador e funcionalidades no OneNote.
Configurar as definições do OneNote: Pode utilizar a Política de Grupo para configurar determinadas definições do OneNote para os seus utilizadores. Para utilizar a Política de Grupo, transfira os ficheiros de Modelo Administrativo (ADMX/ADML) mais recentes para o Office a partir do Centro de Transferências da Microsoft e implemente as definições de política com os Serviços de Domínio do Active Directory (AD DS).
Observação
- A Política de Grupo requer que os dispositivos com o OneNote sejam associados a um domínio do Active Directory.
- A maioria destas mesmas definições de política pode ser aplicada através da Política de Cloud, o que não requer que o dispositivo seja associado a um domínio.
- A Política de Grupo não pode ser utilizada com o Microsoft 365 Apps para empresas ou com o OneNote para Windows 10.
- A Política de Cloud só pode ser utilizada com o Microsoft 365 Apps para Grandes Empresas.
Idiomas suportados: Embora o OneNote e o OneNote para Windows 10 estejam disponíveis na maioria dos mesmos idiomas, existem algumas diferenças. As listas dos idiomas suportados estão disponíveis aqui: OneNote, OneNote para Windows 10
Outras plataformas: Também existem versões do OneNote para Mac, iPad, iPhone, Android e para browsers. Para obter mais informações, consulte Qual é a diferença entre as versões do OneNote?
Artigos relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de