Document capturing app data before reset or repair (AB#23679643)#476
Open
RDMacLachlan wants to merge 1 commit into
Open
Document capturing app data before reset or repair (AB#23679643)#476RDMacLachlan wants to merge 1 commit into
RDMacLachlan wants to merge 1 commit into
Conversation
Adds guidance for capturing an MSIX app's per-user AppData before using Reset or Repair, so a broken app can be diagnosed before its state is lost. Resetting an app permanently deletes its data, so this must be done first. - managing-your-msix-reset-and-repair.md: new "Capture app data before you reset or repair" section covering where packaged app data lives (%LocalAppData%\Packages\<PackageFamilyName>\), the key subfolders, how to find the package family name with Get-AppxPackage, and a Copy-Item backup example. Adds a warning in the Reset section that reset permanently deletes app data, linking to the new section. Resolves AB#23679643 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
|
Learn Build status updates of commit c1edfa6: ✅ Validation status: passed
For more details, please refer to the build report. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Resolves AB#23679643 — [MSIXDocs] MSIX: capture AppData before repairing.
An ask on how to capture an MSIX app's AppData while it's in a broken state, before using Repair/Reset, so they can diagnose the root cause. Because Reset permanently deletes the app's data, there was no guidance telling users to back it up first or where it lives. Per the work item, the fix updates the Reset or Repair MSIX Apps doc.
Change
%LocalAppData%\Packages\<PackageFamilyName>\(=C:\Users\<user>\AppData\Local\Packages\<PackageFamilyName>\), with a table of the key subfolders (LocalState,LocalCache,RoamingState,Settings\settings.dat).Get-AppxPackage.Copy-Itemexample to back up the data before reset/repair.[!WARNING]in the Reset section that reset permanently deletes app data, linking to the new section.ms.date.The obsolete Windows 10X / Device Portal angle from the old comments was intentionally left out, since Windows 10X was cancelled.