Guía de implementación de OneNote

Artículo
08/23/2024

Importante

OneNote para Windows 10 finalizará el soporte técnico en octubre de 2025. Se recomienda que todos los clientes empresariales cambien de OneNote para Windows 10 a OneNote en Windows, que está disponible en Microsoft Store y con una suscripción de Microsoft 365. OneNote en Windows ofrece nuevas características y actualizaciones y le permite personalizar la configuración del usuario a través de la directiva de grupo.

OneNote se incluye junto con otras aplicaciones de Office, como Word, Excel y PowerPoint, al implementar aplicaciones de Microsoft 365, Office LTSC 2021 u Office 2019. No hay ningún otro paso que tenga que seguir para incluir OneNote con nuevas instalaciones de Office. Pero siempre asegúrese de comprobar la configuración de implementación antes de realizar la implementación, por ejemplo, al usar los asistentes en Configuration Manager (rama actual) o Microsoft Intune.

Use la Herramienta de implementación de Office o el software de implementación empresarial como Microsoft Configuration Manager para incluir o excluir OneNote al implementar Office en su organización.

Para agregar OneNote a una instalación existente de Office

Si instala Office en el dispositivo pero falta OneNote, use la Herramienta de implementación de Office y el siguiente archivo configuration.xml para agregar OneNote.

<Configuration>
   <Add>
      <Product ID="OneNoteFreeRetail">
       <Language ID="MatchInstalled"/>
      </Product>
   </Add>
</Configuration>

Al implementar la versión gratuita de OneNote, la licencia se actualiza automáticamente para que coincida con la versión de Office ya instalada en el dispositivo una vez que el usuario abre OneNote por primera vez.

Nota:

El uso de OneNoteFreeRetail no es compatible con las versiones con licencia por volumen de Office, como Office LTSC Professional Plus 2021 u Office Standard 2019. Para volver a agregar OneNote a esas versiones de Office, puede ejecutar una reparación en línea.
Si implementa la versión freemium de OneNote, cuando vaya aProgramas>y características del Panel> de control, OneNote aparecerá como una entrada independiente denominada Microsoft OneNote Home y Student 2016.

Para excluir la instalación de OneNote

Hay diferentes maneras de excluir que OneNote se instale con Office, en función del método de implementación que use, como se muestra en la tabla siguiente.

Método	Instrucciones
Herramienta de implementación de Office	Puede usar el elemento ExcludeApp en el archivo configuration.xml. Se recomienda usar la Herramienta de personalización de Office para ayudarle a crear el archivo de configuration.xml.
Microsoft Configuration Manager (rama actual)	En el Asistente para instalación de cliente de Office 365, puede establecer OneNote en la posición Desactivado al configurar la configuración de Office.
Microsoft Intune	En la página Configurar conjunto de aplicaciones , puede desactivar la casilla de OneNote en la lista desplegable Seleccionar aplicaciones de Office .

Sin embargo, si permite que los usuarios instalen Office por sí mismos desde el portal de Office 365, no hay ninguna manera de excluir la instalación de OneNote.

Guía de migración de OneNote para Windows 10

Nota:

Para garantizar un servicio y un flujo de trabajo ininterrumpidos, se recomienda encarecidamente que las organizaciones migren a OneNote en Windows mucho antes de la fecha de finalización del soporte técnico de OneNote para Windows 10 en octubre de 2025.

En esta sección se proporciona una guía paso a paso para ayudarle a desarrollar una directiva de migración y a ejecutar la transición sin problemas.

Desarrollo de directivas de migración: para facilitar una migración correcta a OneNote en Windows, las organizaciones deben:

Personalice el script de migración.

Use este script de ejemplo para satisfacer las necesidades de su organización.

#############################################
######   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

Asegúrese de que el script realiza las siguientes funciones:

Instala OneNote en Windows en dispositivos de usuario. Consulte la sección Guía de implementación para obtener más información.
Actualiza OneNote para Windows 10 a la compilación más reciente (compilación mínima 16001.14326.21802.0) para incorporar características esenciales que evitan la pérdida de datos durante la migración de notas sin sincronizar.
Finaliza todos los procesos de OneNote para Windows 10.
Realiza una copia de seguridad de los cuadernos sin sincronizar en la carpeta de copia de seguridad del usuario mediante el onenote-cmd://backup: comando .
- Las copias de seguridad se almacenan en , sin embargo, no dude en C:\temp\OneNoteMigrationeditar la ruta de acceso para satisfacer las necesidades de su organización.
- Cada copia de seguridad crea una carpeta correspondiente para cada cuaderno con secciones sin sincronizar dentro de esta ruta de acceso.
Analizar a través de UWPBackUpStatus.json para validar que la copia de seguridad se realizó correctamente.
- La desinstalación con una copia de seguridad con errores puede provocar la pérdida de datos.
Desinstala OneNote para Windows 10.
- Asegúrese de que OneNote para Windows 10 está desinstalado por el usuario y no por dispositivo. Este proceso ayuda a mitigar los escenarios en los que los dispositivos compartidos han quitado notas sin sincronizar para todas las cuentas.

Acceso a las notas migradas

Después de la migración, los usuarios pueden recuperar sus notas mediante:

Abrir la nueva aplicación OneNote en Windows .
Iniciar sesión en su cuenta.
Abrir sus cuadernos.

Si faltan notas, compruebe la carpeta de copia de seguridad que se creó en los pasos anteriores.

Para revisar las copias de seguridad a través de OneNote en Windows:

Vaya a Archivo:> abrir copias de seguridad:> vaya a la ruta de acceso del archivo de copia de seguridad.

Solución de problemas

Revise los UWPBackupStatus.json archivos y UWPSyncStatus.json de la carpeta de copia de seguridad del usuario para obtener información detallada sobre los estados de copia de seguridad y sincronización.
Para ver los errores detectados durante la migración, consulte el archivo de registro ubicado en la copia de seguridad generada anteriormente (paso 1.d).

Si se produce un error en el onenote-cmd://backup: comando:

Asegúrese de que la aplicación OneNote para Windows 10 sea la aplicación predeterminada vinculada al onenote-cmd protocolo.
Consulte el artículo de soporte técnico correspondiente para asegurarse de que los datos adjuntos de protocolo correctos a OneNote para Windows 10.

Precaución

Tenga cuidado al usar los comandos que se encuentran en línea. Pruebe siempre los comandos en un entorno controlado antes de implementarlos en toda la organización para evitar consecuencias involuntarias, como las resultantes del comando Remove-AppxPackage.

Para obtener más ayuda o consultas, póngase en contacto con el soporte técnico de Microsoft.

Información adicional sobre la implementación de OneNote

Recursos de entrenamiento de OneNote

Proporcionamos libros electrónicos gratuitos y compartidos para ayudar a los usuarios a realizar la transición a la interfaz de usuario y las funcionalidades de OneNote.

Configuración de la configuración de OneNote

Puede usar la directiva de grupo para configurar ciertas opciones de OneNote para los usuarios. Para usar la directiva de grupo, descargue los archivos de plantilla administrativa más recientes (ADMX/ADML) para Office desde el Centro de descarga de Microsoft e implemente la configuración de directiva mediante Active Directory Domain Services (AD DS).

Nota:

La directiva de grupo requiere que los dispositivos con OneNote se unan a un dominio de Active Directory.
La mayoría de estas mismas configuraciones de directiva se pueden aplicar mediante Cloud Policy, lo que no requiere que el dispositivo se una a un dominio.
La directiva de grupo no se puede usar con aplicaciones de Microsoft 365 para empresas ni con OneNote para Windows 10.
Cloud Policy solo se puede usar con Aplicaciones de Microsoft 365 para empresas.

Idiomas admitidos

Aunque OneNote y OneNote para Windows 10 están disponibles en la mayoría de los mismos idiomas, hay algunas diferencias. Las listas de los idiomas admitidos están disponibles aquí: OneNote, OneNote para Windows 10

Otras plataformas

También hay versiones de OneNote para Mac, iPad, iPhone, Android y para exploradores web. Para obtener más información, consulte ¿Cuál es la diferencia entre las versiones de OneNote?

Compartir a través de

Guía de implementación de OneNote

Para agregar OneNote a una instalación existente de Office

Para excluir la instalación de OneNote

Guía de migración de OneNote para Windows 10

Acceso a las notas migradas

Solución de problemas

Información adicional sobre la implementación de OneNote

Recursos de entrenamiento de OneNote

Configuración de la configuración de OneNote

Idiomas admitidos

Otras plataformas

Comentarios

Recursos adicionales

Compartir a través de

Guía de implementación de OneNote

Para agregar OneNote a una instalación existente de Office

Para excluir la instalación de OneNote

Guía de migración de OneNote para Windows 10

Acceso a las notas migradas

Solución de problemas

Información adicional sobre la implementación de OneNote

Recursos de entrenamiento de OneNote

Configuración de la configuración de OneNote

Idiomas admitidos

Otras plataformas

Artículos relacionados

Comentarios

Recursos adicionales