Guida alla distribuzione per OneNote
Importante
OneNote per Windows 10 raggiungerà la fine del supporto a ottobre 2025. È consigliabile che tutti i clienti aziendali passino da OneNote per Windows 10 a OneNote in Windows, disponibile da Microsoft Store e con un abbonamento a Microsoft 365. OneNote per Windows offre nuove funzionalità e aggiornamenti e consente di personalizzare le impostazioni utente tramite Criteri di gruppo.
OneNote è incluso insieme alle altre app di Office, ad esempio Word, Excel e PowerPoint, quando si distribuisce Microsoft 365 Apps, Office LTSC 2021 o Office 2019. Non è necessario eseguire altri passaggi per includere OneNote con le nuove installazioni di Office. Assicurarsi tuttavia di controllare sempre le impostazioni di distribuzione prima di eseguire la distribuzione, ad esempio quando si usano le procedure guidate in Configuration Manager (Current Branch) o Microsoft Intune.
Usare lo Strumento di distribuzione di Office o il software di distribuzione aziendale come Microsoft Configuration Manager per includere o escludere OneNote quando si distribuisce Office nell'organizzazione.
Per aggiungere OneNote a un'installazione esistente di Office
Se si installa Office nel dispositivo, ma OneNote è mancante, usare lo strumento di distribuzione di Office e il file di configuration.xml seguente per aggiungere OneNote.
<Configuration>
<Add>
<Product ID="OneNoteFreeRetail">
<Language ID="MatchInstalled"/>
</Product>
</Add>
</Configuration>
Quando si distribuisce la versione gratuita di OneNote, la licenza viene aggiornata automaticamente in modo che corrisponda alla versione di Office già installata nel dispositivo dopo che l'utente apre OneNote per la prima volta.
Nota
- L'uso di OneNoteFreeRetail non è supportato con le versioni con contratti multiplo di Office, ad esempio Office LTSC Professional Plus 2021 o Office Standard 2019. Per aggiungere di nuovo OneNote a tali versioni di Office, è possibile eseguire un ripristino online.
- Se si distribuisce la versione freemium di OneNote, quando si passa aProgrammi>e funzionalitàdel Pannello> di controllo, OneNote verrà visualizzato come voce autonoma denominata Microsoft OneNote Home e Student 2016.
Per escludere OneNote dall'installazione
Esistono diversi modi per escludere OneNote dall'installazione con Office, a seconda del metodo di distribuzione in uso, come illustrato nella tabella seguente.
Metodo | Istruzioni |
---|---|
Strumento di distribuzione di Office | È possibile usare l'elemento ExcludeApp nel file di configuration.xml. È consigliabile usare lo strumento di personalizzazione di Office per creare il file di configuration.xml. |
Microsoft Configuration Manager (Current Branch) | Nell'Installazione guidata client di Office 365 è possibile impostare OneNote sulla posizione Disattivata quando si configurano le impostazioni di Office. |
Microsoft Intune | Nella pagina Configura suite di app è possibile deselezionare la casella di controllo per OneNote nell'elenco a discesa Seleziona app di Office . |
Tuttavia, se si consente agli utenti di installare Office autonomamente dal portale di Office 365, non è possibile escludere OneNote dall'installazione.
Linee guida per la migrazione di OneNote per Windows 10
Nota
Per garantire un servizio e un flusso di lavoro ininterrotti, è consigliabile che le organizzazioni esegretano a OneNote in Windows ben prima della data di fine del supporto di OneNote per Windows 10 di ottobre 2025.
Questa sezione fornisce una guida dettagliata che consente di sviluppare criteri di migrazione ed eseguire la transizione senza problemi.
Sviluppo di criteri di migrazione: per facilitare la corretta migrazione a OneNote in Windows, le organizzazioni devono:
Personalizzare lo script di migrazione.
Usare questo script di esempio per soddisfare le esigenze dell'organizzazione.
#############################################
###### 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
Assicurarsi che lo script esegua le funzioni seguenti:
Installa OneNote in Windows nei dispositivi utente. Per altre informazioni, vedere la sezione Linee guida per la distribuzione.
Aggiorna OneNote per Windows 10 alla build più recente (build minima 16001.14326.21802.0) per incorporare funzionalità essenziali che impediscono la perdita di dati durante la migrazione di note non sincronizzate.
Termina tutti i processi di OneNote per Windows 10.
Esegue il backup di eventuali notebook non sincronizzati nella cartella di backup dell'utente usando il
onenote-cmd://backup:
comando .- I backup vengono archiviati in
C:\temp\OneNoteMigration
, tuttavia, è possibile modificare il percorso in base alle esigenze dell'organizzazione. - Ogni backup crea una cartella corrispondente per ogni notebook con sezioni non sincronizzate all'interno di questo percorso.
- I backup vengono archiviati in
Analizzare l'oggetto
UWPBackUpStatus.json
per convalidare l'esito positivo del backup.- La disinstallazione con un backup non riuscito può causare la perdita di dati.
Disinstalla OneNote per Windows 10.
- Assicurarsi che OneNote per Windows 10 venga disinstallato su base utente e non su base di dispositivo. Questo processo consente di attenuare gli scenari in cui i dispositivi condivisi hanno rimosso note non sincronizzate per tutti gli account.
Accesso alle note migrate
Dopo la migrazione, gli utenti possono recuperare le note:
- Apertura della nuova applicazione OneNote in Windows .
- Accesso al proprio account.
- Apertura dei notebook.
Se mancano note, controllare la cartella di backup creata nei passaggi precedenti.
Per esaminare i backup tramite OneNote in Windows:
- Passare a File -> Apri backup:> passare al percorso del file di backup.
Risoluzione dei problemi
Esaminare i
UWPBackupStatus.json
file eUWPSyncStatus.json
nella cartella di backup dell'utente per informazioni dettagliate sugli stati di backup e sincronizzazione.Per gli errori rilevati durante la migrazione, fare riferimento al file di log che si trova nel backup generato in precedenza (passaggio 1.d).
Se il onenote-cmd://backup:
comando ha esito negativo:
- Assicurarsi che l'app OneNote per Windows 10 sia l'app predefinita collegata al
onenote-cmd
protocollo. - Consultare l'articolo di supporto pertinente per assicurarsi che l'allegato di protocollo corretto a OneNote per Windows 10.
Attenzione
Prestare attenzione quando si usano i comandi trovati online. Testare sempre i comandi in un ambiente controllato prima di distribuirli a livello di organizzazione per evitare conseguenze impreviste, ad esempio quelle risultanti dal comando Remove-AppxPackage.
Per altre informazioni o richieste, contattare il supporto tecnico Microsoft.
Altre informazioni sulla distribuzione di OneNote
Risorse di training di OneNote
Stiamo fornendo eBook gratuiti e condivisibili per aiutare gli utenti a passare all'interfaccia utente e alle funzionalità in OneNote.
Configurare le impostazioni di OneNote
È possibile usare Criteri di gruppo per configurare determinate impostazioni di OneNote per gli utenti. Per usare Criteri di gruppo, scaricare i file dei modelli amministrativi più recenti (ADMX/ADML) per Office dall'Area download Microsoft e implementare le impostazioni dei criteri usando Active Directory Domain Services (AD DS).
Nota
- Criteri di gruppo richiede che i dispositivi con OneNote siano aggiunti a un dominio di Active Directory.
- La maggior parte di queste stesse impostazioni dei criteri può essere applicata usando Criteri cloud, che non richiede l'aggiunta del dispositivo a un dominio.
- Criteri di gruppo non può essere usato con Microsoft 365 Apps for business o con OneNote per Windows 10.
- I criteri cloud possono essere usati solo con Microsoft 365 Apps for enterprise.
Lingue supportate
Anche se sia OneNote che OneNote per Windows 10 sono disponibili nella maggior parte delle stesse lingue, esistono alcune differenze. Gli elenchi delle lingue supportate sono disponibili qui: OneNote, OneNote per Windows 10
Altre piattaforme
Sono disponibili anche versioni di OneNote per Mac, iPad, iPhone, Android e per Web browser. Per altre informazioni, vedere Qual è la differenza tra le versioni di OneNote?