Freigeben über

Bereitstellungshandbuch für OneNote

  • Artikel

Wichtig

OneNote für Windows 10 erreicht das Ende des Supports im Oktober 2025. Es wird empfohlen, dass alle Unternehmenskunden von OneNote für Windows 10 zu OneNote unter Windows wechseln, das im Microsoft Store und mit einem Microsoft 365-Abonnement verfügbar ist. OneNote unter Windows bietet neue Features und Updates und ermöglicht es Ihnen, Benutzereinstellungen über Gruppenrichtlinien anzupassen.

OneNote ist zusammen mit den anderen Office-Apps wie Word, Excel und PowerPoint enthalten, wenn Sie Microsoft 365-Apps, Office LTSC 2021 oder Office 2019 bereitstellen. Es gibt keine weiteren Schritte, die Sie ausführen müssen, um OneNote in neue Installationen von Office einzuschließen. Achten Sie jedoch immer darauf, die Bereitstellungseinstellungen vor der Bereitstellung zu überprüfen, z. B. wenn Sie die Assistenten in Configuration Manager (Current Branch) oder Microsoft Intune verwenden.

Verwenden Sie das Office-Bereitstellungstool oder Unternehmenssoftware wie Microsoft Configuration Manager, um OneNote ein- oder auszuschließen, wenn Sie Office in Ihrer Organisation bereitstellen.

So fügen Sie OneNote einer vorhandenen Office-Installation hinzu

Wenn Sie Office auf Ihrem Gerät installieren, OneNote aber fehlt, verwenden Sie das Office-Bereitstellungstool und die folgende configuration.xml-Datei, um OneNote hinzuzufügen.

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

Wenn Sie die kostenlose Version von OneNote bereitstellen, werden die Lizenzupdates automatisch entsprechend der office-Version aktualisiert, die bereits auf dem Gerät installiert ist, sobald der Benutzer OneNote zum ersten Mal öffnet.

Hinweis

  • Die Verwendung von OneNoteFreeRetail wird bei Volumenlizenzversionen von Office wie Office LTSC Professional Plus 2021 oder Office Standard 2019 nicht unterstützt. Um OneNote diesen Versionen von Office wieder hinzuzufügen, können Sie eine Onlinereparatur ausführen.
  • Wenn Sie die Freemium-Version von OneNote bereitstellen und zu Systemsteuerung>Programme>und Features wechseln, wird OneNote als eigenständiger Eintrag namens Microsoft OneNote Home and Student 2016 angezeigt.

So schließen Sie oneNote von der Installation aus

Es gibt verschiedene Möglichkeiten, oneNote von der Installation mit Office auszuschließen, je nachdem, welche Bereitstellungsmethode Sie verwenden, wie in der folgenden Tabelle gezeigt.

Methode Anweisungen
Office-Bereitstellungstool Sie können das ExcludeApp-Element in Ihrer configuration.xml-Datei verwenden.

Es wird empfohlen, das Office-Anpassungstool zu verwenden, um Ihre configuration.xml-Datei zu erstellen.
Microsoft Configuration Manager (Current Branch) Im Office 365-Clientinstallations-Assistenten können Sie OneNote auf die Position Aus festlegen, wenn Sie die Office-Einstellungen konfigurieren.
Microsoft Intune Auf der Seite App-Suite konfigurieren können Sie das Kontrollkästchen für OneNote in der Dropdownliste Office-Apps auswählen deaktivieren.

Wenn Sie Ihren Benutzern jedoch erlauben, Office über das Office 365-Portal selbst zu installieren, gibt es keine Möglichkeit, OneNote von der Installation auszuschließen.

Migrationsleitfaden für OneNote für Windows 10

Hinweis

Um einen unterbrechungsfreien Dienst und Workflow sicherzustellen, wird dringend empfohlen, dass Organisationen weit vor dem Ende des Supports von OneNote für Windows im Oktober 2025 zu OneNote für Windows 2025 migrieren.

Dieser Abschnitt enthält eine Schritt-für-Schritt-Anleitung, die Sie beim Entwickeln einer Migrationsrichtlinie und beim reibungslosen Ausführen des Übergangs unterstützt.

Entwicklung von Migrationsrichtlinien: Organisationen sollten folgende Aufgaben ausführen, um eine erfolgreiche Migration zu OneNote unter Windows zu ermöglichen:

Passen Sie das Migrationsskript an.

Verwenden Sie dieses Beispielskript, um die Anforderungen Ihrer Organisation zu erfüllen.

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

Stellen Sie sicher, dass das Skript die folgenden Funktionen ausführt:

  • Installiert OneNote unter Windows auf Benutzergeräten. Weitere Informationen finden Sie im Abschnitt Bereitstellungsleitfaden.

  • Aktualisiert OneNote für Windows 10 auf den neuesten Build (min. Build 16001.14326.21802.0), um wichtige Features zu integrieren, die Datenverluste während der Migration nicht synchronisierter Notizen verhindern.

  • Beendet alle OneNote für Windows 10-Prozesse.

  • Sichert alle nicht synchronisierten Notebooks mithilfe des Befehls im Sicherungsordner des onenote-cmd://backup: Benutzers.

    • Die Sicherungen werden in C:\temp\OneNoteMigrationgespeichert. Sie können den Pfad jedoch an die Anforderungen Ihrer Organisation anpassen.
    • Jede Sicherung erstellt einen entsprechenden Ordner für jedes Notebook mit nicht synchronisierten Abschnitten innerhalb dieses Pfads.

  • Analysieren Sie die UWPBackUpStatus.json , um zu überprüfen, ob die Sicherung erfolgreich war.

    • Die Deinstallation mit einer fehlerhaften Sicherung kann zu Datenverlusten führen.

  • Deinstalliert OneNote für Windows 10.

    • Stellen Sie sicher, dass OneNote für Windows 10 auf Benutzerbasis und nicht auf Gerätebasis deinstalliert wird. Dieser Prozess trägt dazu bei, Szenarien zu entschärfen, in denen für freigegebene Geräte nicht synchronisierte Notizen für alle Konten entfernt wurden.

Zugreifen auf migrierte Notizen

Nach der Migration können Benutzer ihre Notizen wie folgt abrufen:

  1. Öffnen der neuen OneNote-Anwendung unter Windows .
  2. Anmelden bei ihrem Konto.
  3. Öffnen der Notizbücher.

Wenn Notizen fehlen, überprüfen Sie den Sicherungsordner, der in den vorherigen Schritten erstellt wurde.

So überprüfen Sie Sicherungen über OneNote unter Windows:

  • Navigieren Sie zu Datei –> Sicherungen öffnen –> Navigieren Sie zum Pfad der Sicherungsdatei.

Problembehandlung

  • Überprüfen Sie die UWPBackupStatus.json Dateien und UWPSyncStatus.json im Sicherungsordner des Benutzers, um ausführliche Informationen zum Sicherungs- und Synchronisierungsstatus zu finden.

  • Informationen zu Fehlern, die während der Migration auftreten, finden Sie in der Protokolldatei in der zuvor generierten Sicherung (Schritt 1.d).

Wenn der onenote-cmd://backup: Befehl fehlschlägt:

  • Stellen Sie sicher, dass die OneNote für Windows 10-App die Standard-App ist, die mit dem onenote-cmd Protokoll verknüpft ist.
  • Lesen Sie den entsprechenden Supportartikel, um sicherzustellen, dass die richtige Protokollanlage zu OneNote für Windows 10 vorhanden ist.

Achtung

Seien Sie vorsichtig, wenn Sie online gefundene Befehle verwenden. Testen Sie Befehle immer in einer kontrollierten Umgebung, bevor Sie sie organisationsweit bereitstellen, um unbeabsichtigte Folgen zu vermeiden, z. B. solche, die sich aus dem Remove-AppxPackage-Befehl ergeben.

Wenden Sie sich an den Microsoft-Support, um weitere Unterstützung oder Anfragen zu erhalten.

Zusätzliche Informationen zum Bereitstellen von OneNote

OneNote-Schulungsressourcen

Wir stellen kostenlose und freigegebene E-Books bereit, die Ihren Benutzern beim Übergang zur Benutzeroberfläche und den Funktionen in OneNote helfen.

Konfigurieren von OneNote-Einstellungen

Sie können gruppenrichtlinien verwenden, um bestimmte OneNote-Einstellungen für Ihre Benutzer zu konfigurieren. Um Gruppenrichtlinien zu verwenden, laden Sie die neuesten administrativen Vorlagendateien (ADMX/ADML) für Office aus dem Microsoft Download Center herunter, und implementieren Sie die Richtlinieneinstellungen mithilfe von Active Directory Domain Services (AD DS).

Hinweis

  • Die Gruppenrichtlinie erfordert, dass die Geräte mit OneNote in eine Active Directory-Domäne eingebunden sind.
  • Die meisten dieser Richtlinieneinstellungen können mithilfe der Cloudrichtlinie angewendet werden, die nicht erfordert, dass das Gerät einer Domäne hinzugefügt wird.
  • Gruppenrichtlinien können nicht mit Microsoft 365 Apps for Business oder oneNote für Windows 10 verwendet werden.
  • Cloudrichtlinien können nur mit Microsoft 365 Apps for Enterprise verwendet werden.

Unterstützte Sprachen

Sowohl OneNote als auch OneNote für Windows 10 sind in den meisten der gleichen Sprachen verfügbar, es gibt jedoch einige Unterschiede. Die Listen der unterstützten Sprachen sind hier verfügbar: OneNote, OneNote für Windows 10

Andere Plattformen

Es gibt auch Versionen von OneNote für Mac, iPad, iPhone, Android und für Webbrowser. Weitere Informationen finden Sie unter Was ist der Unterschied zwischen den OneNote-Versionen?