Partager via

Guide de déploiement pour OneNote

  • Article

Importante

OneNote pour Windows 10 prendra fin en octobre 2025. Il est recommandé que tous les clients d’entreprise passent de OneNote pour Windows 10 à OneNote sur Windows, qui est disponible à partir du Microsoft Store et avec un abonnement Microsoft 365. OneNote sur Windows offre de nouvelles fonctionnalités et mises à jour et vous permet de personnaliser les paramètres utilisateur via une stratégie de groupe.

OneNote est inclus avec les autres applications Office, telles que Word, Excel et PowerPoint, lorsque vous déployez Microsoft 365 Apps, Office LTSC 2021 ou Office 2019. Vous n’avez pas d’autres étapes à suivre pour inclure OneNote avec de nouvelles installations d’Office. Toutefois, veillez toujours à vérifier les paramètres de déploiement avant de déployer, par exemple lors de l’utilisation des Assistants dans Configuration Manager (Current Branch) ou Microsoft Intune.

Utilisez l’outil Déploiement d’Office ou un logiciel de déploiement d’entreprise comme Microsoft Configuration Manager pour inclure ou exclure OneNote lorsque vous déployez Office dans votre organisation.

Pour ajouter OneNote à une installation existante d’Office

Si vous installez Office sur votre appareil mais que OneNote est manquant, utilisez l’outil Déploiement d’Office et le fichier configuration.xml suivant pour ajouter OneNote.

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

Lorsque vous déployez la version gratuite de OneNote, la licence est automatiquement mise à jour pour correspondre à la version d’Office déjà installée sur l’appareil une fois que l’utilisateur ouvre OneNote pour la première fois.

Remarque

  • L’utilisation de OneNoteFreeRetail n’est pas prise en charge avec les versions sous licence en volume d’Office, telles qu’Office LTSC Professionnel Plus 2021 ou Office Standard 2019. Pour rajouter OneNote à ces versions d’Office, vous pouvez exécuter une réparation en ligne.
  • Si vous déployez la version freemium de OneNote, lorsque vous accédez au Panneau de configuration>Programmes>et fonctionnalités, OneNote apparaît sous la forme d’une entrée autonome nommée Microsoft OneNote Famille et Étudiant 2016.

Pour exclure l’installation de OneNote

Il existe différentes façons d’exclure OneNote de l’installation avec Office, selon la méthode de déploiement que vous utilisez, comme indiqué dans le tableau suivant.

Méthode Instructions
Outil Déploiement d’Office Vous pouvez utiliser l’élément ExcludeApp dans votre fichier configuration.xml.

Nous vous recommandons d’utiliser l’outil de personnalisation Office pour vous aider à créer votre fichier configuration.xml.
Microsoft Configuration Manager (Current Branch) Dans l’Assistant Installation du client Office 365, vous pouvez définir OneNote sur la position Désactivé lorsque vous configurez les paramètres Office.
Microsoft Intune Dans la page Configurer la suite d’applications , vous pouvez décochez la case OneNote dans la liste déroulante Sélectionner des applications Office .

Toutefois, si vous autorisez vos utilisateurs à installer Office pour eux-mêmes à partir du portail Office 365, il n’existe aucun moyen d’exclure OneNote de l’installation.

Guide de migration de OneNote pour Windows 10

Remarque

Pour garantir un service et un flux de travail ininterrompus, il est vivement recommandé aux organisations de migrer vers OneNote sur Windows bien avant la date de fin du support oneNote pour Windows 10 en octobre 2025.

Cette section fournit un guide pas à pas pour vous aider à développer une stratégie de migration et à exécuter la transition en douceur.

Développement d’une stratégie de migration : pour faciliter une migration réussie vers OneNote sur Windows, les organisations doivent :

Personnalisez le script de migration.

Utilisez cet exemple de script pour répondre aux besoins de votre organisation.

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

Vérifiez que le script exécute les fonctions suivantes :

  • Installe OneNote sur Windows sur les appareils des utilisateurs. Pour plus d’informations, reportez-vous à la section Guide de déploiement.

  • Met à jour OneNote pour Windows 10 vers la dernière version (build min 16001.14326.21802.0) pour incorporer des fonctionnalités essentielles qui empêchent la perte de données pendant la migration de notes non synchronisées.

  • Met fin à tous les processus OneNote pour Windows 10.

  • Sauvegarde tous les notebooks non synchronisés dans le dossier de sauvegarde de l’utilisateur à l’aide de la onenote-cmd://backup: commande .

    • Les sauvegardes sont stockées dans C:\temp\OneNoteMigration, mais n’hésitez pas à modifier le chemin d’accès en fonction des besoins de votre organisation.
    • Chaque sauvegarde crée un dossier correspondant pour chaque bloc-notes avec des sections non synchronisées dans ce chemin d’accès.

  • Analyser dans le UWPBackUpStatus.json pour vérifier que la sauvegarde a réussi.

    • La désinstallation avec une sauvegarde ayant échoué peut entraîner une perte de données.

  • Désinstalle OneNote pour Windows 10.

    • Vérifiez que OneNote pour Windows 10 est désinstallé sur une base utilisateur et non sur un appareil. Cela permet d’atténuer les scénarios dans lesquels des notes non synchronisées sont supprimées pour tous les comptes sur les appareils partagés.

Accès aux notes migrées

Après la migration, les utilisateurs peuvent récupérer leurs notes en :

  1. Ouverture de la nouvelle application OneNote sur Windows .
  2. Connexion à son compte.
  3. Ouverture de leurs blocs-notes.

Si des notes sont manquantes, vérifiez le dossier de sauvegarde qui a été créé au cours des étapes précédentes.

Pour passer en revue les sauvegardes via OneNote sur Windows :

  • Accédez à Fichier -> Ouvrir les sauvegardes -> Accédez au chemin du fichier de sauvegarde.

Résolution des problèmes

  • Passez en revue les UWPBackupStatus.json fichiers et UWPSyncStatus.json dans le dossier de sauvegarde de l’utilisateur pour obtenir des informations détaillées sur les états de sauvegarde et de synchronisation.

  • Pour les erreurs rencontrées pendant la migration, reportez-vous au fichier journal situé dans la sauvegarde générée précédemment (étape 1.d).

Si la onenote-cmd://backup: commande échoue :

  • Vérifiez que l’application OneNote pour Windows 10 est l’application par défaut liée au onenote-cmd protocole.
  • Consultez l’article de support approprié pour vérifier que le protocole est bien joint à OneNote pour Windows 10.

Attention

Soyez prudent lorsque vous utilisez des commandes trouvées en ligne. Testez toujours les commandes dans un environnement contrôlé avant de les déployer à l’échelle de l’organisation pour éviter les conséquences inattendues, telles que celles résultant de la commande Remove-AppxPackage.

Pour obtenir de l’aide ou des demandes de renseignements supplémentaires, contactez le support Microsoft.

Informations supplémentaires sur le déploiement de OneNote

Ressources de formation OneNote Nous fournissons des livres électroniques gratuits et partageables pour aider vos utilisateurs à passer à l’interface utilisateur et aux fonctionnalités de OneNote.

Configurer les paramètres OneNote : Vous pouvez utiliser la stratégie de groupe pour configurer certains paramètres OneNote pour vos utilisateurs. Pour utiliser la stratégie de groupe, téléchargez les derniers fichiers de modèle d’administration (ADMX/ADML) pour Office à partir du Centre de téléchargement Microsoft et implémentez les paramètres de stratégie à l’aide des services de domaine Active Directory (AD DS).

Remarque

  • La stratégie de groupe nécessite que les appareils avec OneNote soient joints à un domaine Active Directory.
  • La plupart de ces mêmes paramètres de stratégie peuvent être appliqués à l’aide de la stratégie cloud, ce qui ne nécessite pas que l’appareil soit joint à un domaine.
  • La stratégie de groupe ne peut pas être utilisée avec Microsoft 365 Apps for business ou avec OneNote pour Windows 10.
  • La stratégie cloud ne peut être utilisée qu’avec Microsoft 365 Apps for enterprise.

Langues prises en charge : Bien que OneNote et OneNote pour Windows 10 soient disponibles dans la plupart des mêmes langues, il existe quelques différences. Les listes des langues prises en charge sont disponibles ici : OneNote, OneNote pour Windows 10

Autres plateformes : Il existe également des versions de OneNote pour Mac, iPad, iPhone, Android et pour les navigateurs web. Pour plus d’informations, consultez Quelle est la différence entre les versions de OneNote ?