Summary
This article helps you diagnose and fix issues that affect modern apps, inbox apps, and Microsoft Store apps. Such issues can prevent apps from starting or launching, or cause apps to stop responding in Windows. This article provides a systematic troubleshooting approach for support agents and IT professionals. This article includes step-by-step guidance for fixing the following common issues:
- Apps aren't registered or installed correctly for user accounts
- App activation fails, requiring re-registration
- Corrupted or missing app packages
- Permission issues affect app functionality
- AppLocker policies block apps
The troubleshooting guidance includes Windows PowerShell commands, registry and file permission checks, and data collection methods to help identify and fix app-related issues.
Note:
This article is intended for use by support agents and IT professionals. If you're looking for more general information, see Repair apps and programs in Windows.
Troubleshooting checklist
- Verify if the application is registered or installed for your user.
- Re-register the application for the user may resolve activation issues.
- If you receive no response to the Get-AppxPackage cmdlet, you can still use the Add-AppxPackage cmdlet.
- For the XML path, you need to check which version you have installed.
- If the application still fails to start after re-registration, perhaps the package for the application is corrupted or missing some components.
- For a single application, you can use the winget command.
- Check if the system setup has appropriate settings to download and install AppX packages.
- If Microsoft Store has issues starting or was previously removed, try reinstalling it.
- If the application still fails, some event logs might be helpful.
Here's the detailed troubleshooting checklist:
-
<a id="checklist-1"></a>Verify if the application is registered or installed for your user.
Modern Apps are deployed as a package onto a machine and then need to register individually for each user that logs in. A record is kept on each machine for every application and which users have it registered. For example, to see if an individual user has the Calculator application installed, use the following cmdlet in a nonadministrative Windows PowerShell command prompt:
Get-AppxPackage *calculator*If it's registered, the output looks like the following:
Name : Microsoft.WindowsCalculator Publisher : CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US Architecture : X64 ResourceId : Version : 11.2210.0.0 PackageFullName : Microsoft.WindowsCalculator_11.2210.0.0_x64__8wekyb3d8bbwe InstallLocation : C:\Program Files\WindowsApps\Microsoft.WindowsCalculator_11.2210.0.0_x64__8wekyb3d8bbwe IsFramework : False PackageFamilyName : Microsoft.WindowsCalculator_8wekyb3d8bbwe PublisherId : 8wekyb3d8bbwe IsResourcePackage : False IsBundle : False IsDevelopmentMode : False NonRemovable : False Dependencies : {Microsoft.UI.Xaml.2.8_8.2212.15002.0_x64__8wekyb3d8bbwe, Microsoft.NET.Native.Framework.2.2_2.2.29512.0_x64__8wekyb3d8bbwe, Microsoft.NET.Native.Runtime.2.2_2.2.28604.0_x64__8wekyb3d8bbwe, Microsoft.VCLibs.140.00_14.0.30704.0_x64__8wekyb3d8bbwe...} IsPartiallyStaged : False SignatureKind : Store Status : Ok -
<a id="checklist-2"></a>Even if the application is shown as registered for your user, sometimes re-registering the application for the user can resolve activation issues because it repairs any missing entries for the package. Use the following cmdlet at the same nonelevated PowerShell prompt (this example is for the Calculator application):
Get-AppxPackage *calculator*| Foreach {Add-AppxPackage -DisableDevelopmentMode -Register "$($_.InstallLocation)\AppXManifest.xml"}[!NOTE]
Notice how we return the output from theGet-AppxPackagecmdlet to feed into theAdd-AppxPackagecmdlet using the pipe|cmdlet. This only works if the package is already registered. -
<a id="checklist-3"></a>If you receive no response to the
Get-AppxPackagecmdlet, you can still use theAdd-AppxPackagecmdlet by using the family name or the path to the AppxManifest.xml file.This is possible because although this user doesn't have the package registered, other users might. This means that the package will still exist on the machine.
To check this, add
-AllUsersto the sameGet-AppxPackagecmdlet we used earlier in an elevated PowerShell prompt:Get-AppxPackage *calculator* -AllUsersIf there's a successful return of the app details, it means that the package exists.
Use one of the following cmdlets to try to register the app for this user.
Be sure not to use the elevated PowerShell prompt unless you wish to register the app to the administrator instead of the user.
Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.WindowsCalculator_8wekyb3d8bbweAdd-AppxPackage -path "c:\Program Files\WindowsApps\Microsoft.WindowsCalculator_11.2210.0.0_x64__8wekyb3d8bbwe\AppxManifest.xml" -DisableDevelopmentMode -RegisterFor a System Application, the XML path is slightly different:
Add-AppxPackage -Path "C:\Windows\SystemApps\Microsoft.Windows.Search_cw5n1h2txyewy\AppXManifest.xml" -DisableDevelopmentMode -Register[!NOTE]
Be sure to use theAdd-AppxPackagecmdlet from a non-elevated prompt, or the package will be registered to the admin instead of the user. -
<a id="checklist-4"></a>For the XML path, you need to check which version you have installed. You can do this from an administrative PowerShell prompt by using a
dircmdlet:dir "c:\Program Files\WindowsApps\Microsoft.WindowsCalculator*"The output looks like the following example:
Directory: C:\Program Files\WindowsApps Mode LastWriteTime Length Name d----- <Date> <Time> Microsoft.WindowsCalculator_11.2210.0.0_x64__8wekyb3d8bbwe -
<a id="checklist-5"></a>If the application still fails to start after basic re-registration, try using the Reset-AppxPackage cmdlet to restore the app to the original configuration. If the app is still not working, perhaps the package for the application is corrupted or missing some components. Get a new package for the machine by using Microsoft Store (public or private) or Windows Package Manager (winget). For more information, see Troubleshoot Apps failing to start using Windows Package Manager.
-
<a id="checklist-6"></a>For a single application, you can use the
wingetcommand. To search for an application, use the following command:winget search <AppName>After you have confirmed that the application you want is available, you can install it by using the following command:
winget install <AppName>The winget tool launches the installer and installs the application on your computer. For example:
:::image type="content" source="media/modern-inbox-store-apps-troubleshooting-guidance/search-powertoys.png" alt-text="Screenshot that shows the result of searching Microsoft PowerToys.":::
To avoid the license prompts, you can use a small, scripted command:
winget install --exact --silent --accept-source-agreements --accept-package-agreements XP89DCGQ3K6VLD --source msstoreYou can search for available applications using winget search. The application ID can be pulled from the search.
-
<a id="checklist-7"></a>Check if the system setup has appropriate settings to download and install AppX packages.
-
<a id="checklist-8"></a>If Microsoft Store has issues starting or was previously removed, try reinstalling it.
[!NOTE]
Removing Microsoft Store is not supported. For more information, see Removing, uninstalling, or reinstalling Microsoft Store app isn't supported. -
<a id="checklist-9"></a>If the application still fails, the following event logs might be helpful.
- Application Event Log
- System Event Log
- Microsoft-Windows-AppXDeploymentServer/Operational (Applications and Services\Microsoft\Windows\AppXDeployment-Server)
- Microsoft-Windows-TWinUI/Operational (Applications and Services\Microsoft\Windows\Apps)
- Admin (Applications and Services\Microsoft\Windows\AppModel-Runtime)
Common issues and solutions
Use PowerShell to remove an Appx package
Appx packages can be removed by using the Remove-AppxPackage appx cmdlet. The cmdlet can be used in one of the following scenarios:
- An App isn't working. You want to reinstall the App to resolve the malfunction.
- You need to remove unwanted inbox Apps.
- You need to uninstall Apps flagged as vulnerable by security software.
Warning:
Removing an Appx Package can be irreversible. Make sure you are running these commands from the correct User's context, and for the correct Package.
Warning:
Removing the Microsoft Store App is not supported. For more information, see Removing, uninstalling, or reinstalling Microsoft Store app isn't supported.
To remove the App, follow these steps:
Determine whether the App that you want to remove is registered or installed for the user account.
Get-AppxPackage -Name <App_name>
If you can see an output for the above command, the App is registered for the user's account.
Certain Appx packages, such as System Apps, can't be removed. The NonRemovable attribute in the output of the Get-AppxPackage cmdlet indicates whether an Appx package can be removed. Make sure the package you're trying to remove doesn't have NonRemovable attribute set to True.
Now you can use the Remove-AppxPackage cmdlet to remove the App for the user's account.
Remove-AppxPackage -Package '<package_name>'
To remove the App for all user accounts on the computer, you can add the -AllUsers switch. Running the command requires Administrator permission.
Remove-AppxPackage -Package '<package_name>' -AllUsers
Note:
In this command, <package_name> represents the package that you want to remove.
The Remove-AppxPackage command has other switches that can be used to customize its behavior. For more information about the command, see Remove-AppxPackage.
Application is blocked
You receive the following events in the logs:
Log Name: Microsoft-Windows-AppXDeploymentServer/Operational
Source: Microsoft-Windows-AppXDeployment-Server
Event ID: 404
Level: Error
Keywords: AppXDeploymentServer Keyword
Description:
AppX Deployment operation failed for package Microsoft.Windows.StartMenuExperienceHost_10.0.22621.1_neutral_neutral_cw5n1h2txyewy with error 0x80073D01. The specific error text for this failure is: error 0x800704EC: Deployment of package Microsoft.Windows.StartMenuExperienceHost_10.0.22621.1_neutral_neutral_cw5n1h2txyewy **was blocked by AppLocker**.
Log Name: Microsoft-Windows-AppLocker/Packaged app-Execution
Source: Microsoft-Windows-AppLocker
Event ID: 8022
Level: Error
Description:
MICROSOFT.WINDOWS.SEARCH was prevented from running.
Log Name: Microsoft-Windows-TWinUI/Operational
Source: Microsoft-Windows-Immersive-Shell
Event ID: 5961
Level: Error
Description:
Activation for MicrosoftWindows.Client.CBS_cw5n1h2txyewy!FESearchUI failed. Error code: **This program is blocked by group policy**. For more information, contact your system administrator. Activation phase: Deployment
You need to remove AppLocker restrictions. For AppLocker to stop enforcing its rules, two things need to happen in sequence:
- The effective policy on the client computer is emptied.
- The AppLocker service is disabled.
The AppLocker rules remain enforced even though the service has been stopped and the rules have been deleted from the user interface. This can occur when a Group Policy administrator deletes all AppLocker rules and disables the AppLocker service in a single Group Policy update. The effect of this is that the AppLocker service is disabled before it can update the effective policy on the client computer. As a result, AppLocker rules continue to be enforced.
Solution
To resolve this condition, remove all AppLocker rules and stop the service. That is, delete all the AppLocker rules in the Group Policy Object (GPO), push out that update to allow the empty AppLocker policy to be applied on the client computers, and then separately disable the service on those client computers. For more information, see AppLocker Rules Still Enforced After the Service is Stopped.
To terminate AppLocker rule enforcement, follow these steps:
- Back up the GPO that contains the currently applied AppLocker rules.
- Delete all the AppLocker rules on that GPO. For detailed steps, see AppLocker Policy Procedures.
- Push out the GPO that contains the empty AppLocker policy to the affected client computers. For detailed steps, see Refresh an AppLocker Policy.
- Disable the AppLocker service (appidsvc) on all the affected client computers. Optionally, you can restart the service. For detailed steps, see Configure the Application Identity Service. Alternatively, you can disable the AppLocker service using Group Policy instead of disabling locally.
- Optionally, if you want to update the computers to another set of AppLocker rules (and the service has been enabled), you can force a Group Policy update for the revised AppLocker policy. For detailed steps, see Refresh an AppLocker Policy.
Bad permissions being set on registry keys or folders
The general rule is to avoid changing the permissions on registry keys owned by the operating system. Even for hardening purposes, we don't recommend changing the permissions or the ownership from the registry key, files, or folders from Windows. That action might break your system and possibly require a rebuild to fix.
The applications are installed to run in the user context and require the correct permission for the user and All Application Packages to be able to launch.
Permission issues often affect folders or registry hives, including the following folders and subkeys:
- C:\Program Files\WindowsApps
- C:\ProgramData\Microsoft\Windows\AppRepository
- C:\Users
HKCU\Software\ClassesHKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell FoldersHKLM\SOFTWARE\Microsoft\OLE
You can use the following Get-Acl cmdlet in PowerShell to check folder permissions:
Get-Acl -Path HKLM:\SOFTWARE\Microsoft\OLE | Format-List
Get-Acl C:\ProgramData\Microsoft\Windows\AppRepository
You can also use the Process Monitor tool to trace the app that can't start. See Troubleshoot Apps Failing to Start Using Process Monitor.
If using the Process Monitor tool isn't an option, you can check the above folders against a working computer. Start from a new computer in an Organizational Unit (OU) that doesn't have policies, and add policies one by one until the applications break.
Once you find the incorrect permissions, try to fix the permissions to avoid the possibility of a complete rebuild of the system. Take care in making corrective changes and notice the source of the permission change. A policy reapplication might wipe out all your hard work if the incorrect policy isn't identified before making the changes. Perhaps move into a separate OU or block policy application when doing the investigation.
Remember that moving a computer from an OU doesn't automatically reset all the permissions to default. They must be explicitly turned off, not set to Not configured. It's similar to a policy where "turn tap on" isn't changed until "turn tap off" is set. Not configured doesn't change the "on" status.
If you aren't sure which GPO is affecting the system and have many GPOs applied, try to reset the Local Group Policy settings using a command prompt as a test. This action only sets the values to default, so if a policy was set to Enabled previously, and the default setting is Not configured and the default state is Disabled, it doesn't actually disable the corresponding registry setting, as explained above.
To use a command prompt to reset the Group Policy settings, follow these steps:
-
Open a command prompt window as an administrator.
-
Enter the following command to reset all the Group Policy settings and press <kbd>Enter</kbd>:
RD /S /Q "%WinDir%\System32\GroupPolicyUsers" && RD /S /Q "%WinDir%\System32\GroupPolicy" -
To update the changes in the Local Group Policy console, run the following command at the Windows command prompt:
gpupdate /force -
Restart your computer (not required but recommended).
After you complete the steps, the command deletes the folders that store the Group Policy settings on your device. Then Windows 10 or Windows 11 should reapply the default values.
These instructions don't reset the objects under the "Windows Security" (Local Security Policy) section, because they're stored in a different location.
If the permissions are incorrect, always apply from the highest level and allow down-inheritance to your target directory.
If the Bypass traverse checking user right is missing, the permissions on the directory might be correct, but the user can't use of any inherited permissions. Check that you aren't missing anyone in Bypass traverse checking (Windows 10).
Finally, if you can't locate the permission issue causing the problem and only a few machines are involved, recovering the machine and refreshing it to a clean image may solve the problem.
Data collection
Before contacting Microsoft support, you can gather information about your issue.
Prerequisites
Refer to Introduction to TroubleShootingScript toolset (TSSv2) for prerequisites for the toolset to run properly.
Gather key information before contacting Microsoft support
-
Download TSSv2 and extract it in the C:\tss_tool folder. If you've downloaded this tool previously, we recommend downloading the latest version. It doesn't automatically update when running.
-
Open the C:\tss_tool folder from an elevated PowerShell command prompt.
[!NOTE]
Don't use the Windows PowerShell Integrated Scripting Environment (ISE). -
Run the following cmdlet and enter A for "Yes to All" for the execution policy change.
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -
Run the following cmdlets to start tracing and collect the event logs.
.\tss.ps1 -scenario PRF_UWP.\tss.ps1 -CollectLog PRF_AppX
The traces are stored in a compressed file in the C:\MSDATA folder. You can attach this file to your support request for analysis.
Source: Microsoft Learn / IT Pro troubleshooting by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
