Fix problems that block programs from being installed or removed

Note: Use these steps for Windows programs. If you’re having problems with an app you got from Microsoft Store, go to Fix problems with apps from Microsoft Store.

The Program Install and Uninstall troubleshooter helps you automatically repair issues when you’re blocked from installing or removing programs. It also fixes corrupted registry keys.

First, you’ll need to download the troubleshooter.

If you see the File Download box when you start downloading, select Run or Open.

The troubleshooter provides steps for you to follow. If a program isn’t listed in the uninstall options, you’ll be asked for that program’s product code. To access the code, you’ll need a tool for reading MSI files—which is typically available to IT professionals. You’ll find the product code in the property table of the MSI file.

What it fixes

The troubleshooter helps fix problems that:

Corrupt registry keys on 64-bit operating systems.

Corrupt registry keys that control the update data.

Prevent new programs from being installed.

Prevent existing programs from being completely uninstalled or updated.

Block you from uninstalling a program through Add or Remove Programs (or Programs and Features) in Control Panel.

If you’re trying to remove malware, you can use Windows Security (or another antivirus tool), or you can use the Windows Malicious Software Removal tool.

Troubleshoot installation issues with the App Installer file

If you find any issues when installing an application from the App Installer file, this topic will provide some troubleshooting guidance that may help.

Prerequisites

To be able to sideload apps in Windows 10, the user device must satisfy the next requirements:

• The device must be enabled for Developer Mode or Sideloading apps. See Enable your device for development to learn more.
• The certificate used to sign the package must be trusted by the device. See the Trusted certificates section below for more details.
• The Windows 10 version must support the .appinstaller file schema and the distribution protocol.

Common issues

There are some common issues when sideloading an application for first time in the user machine. The next few sections describe the most frequent issues and their solutions.

Windows version

Each Windows 10 release improves on the sideloading experience, in the table below you will find which features are available in each major release. If you try to sideload an app using a method not supported in your version of Windows 10, you will get a deployment error.

Version	Sideload Notes
Build 17134 (April 2018 Update, version 1803)	The .appinstaller file can be accessed over UNC/Share folders. Configurable update checks are also available.
Build 16299 (Fall Creators Update, version 1709)	Introduced the .appinstaller file to provide automatic updates to your app. This version only supports HTTP endpoints. Update checks are not configurable and happens each 24 hours.
Build 15063 (Creators Update, version 1703)	The App Installer app is able to download app dependencies (only in release mode) from the Store.
Build 14393 (Anniversary Update, version 1607)	Introduced the App Installer app to install .appx and .appxbundle files, .appinstaller file is not supported.
Build 10586 (November Update, version 1511)	Sideload is only available through PowerShell using the Add-AppxPackage command.
Build 10240 (Windows 10, version 1507)	Sideload is only available through PowerShell using the Add-AppxPackage command.

Trusted certificates

App packages must be signed with a certificate that is trusted by the device. Certificates provided by common Certificate Authorities are trusted by default in the Windows operating system.

However, if the certificate used to sign an app package is not trusted, or is a locally-generated/self-signed certificate used during development, the app installer may report that the package is untrusted and will prevent it from being installed:

To solve this issue, a user with local administrator rights to the device must use the Computer Certificates tool to import the certificate into one of the following containers:

1. Local Computer: Trusted People
2. Local Computer: Trusted Root Authorities (not recommended)

Do not import package signing certificates into the User Certificate store. The App Installer does not search User Certificates when verifying package identity.

The Computer Certificates management tool can be easily found by searching from the Start Menu:

Once the signing certificate is successfully imported, re-running the app installer will show that the package is trusted and can be installed:

Dependencies not installed

Windows 10 applications can have framework dependencies based on the application platform used to generate the app. If you are using C# or VB, the app will require the .NET Runtime and .NET framework packages. C++ applications require the VCLibs.

If the app package is built in Release mode configuration, the framework dependencies will be obtained from the Microsoft Store. However, if the app is built in Debug mode configuration, the dependencies will be obtained from the location specified in the .appinstaller file.

Files not accessible

When installing from an HTTP endpoint, it is important to verify that all files are accessible with the correct MIME type. The easiest method to verify these files is by following the links provided in the HTML page generated by Visual Studio. You must check these files:

• .appinstaller file, available as an application/xml
• .appx and .appxbundle files, available as application/vns.ms-appx

Isolate App Installer app issues

If the App Installer cannot install the app, these steps will help identify the installation issue.

Verify app package file installation

Download the app package file to a local folder and try to install it using the Add-AppxPackage PowerShell command.

Download the .appinstaller file to a local folder and try to install it using the Add-AppxPackage -Appinstaller PowerShell command.

App Installer event logs

The app deployment infrastructure emits logs that are often useful for debugging installation issues via the Windows Event Viewer: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server

Устранение неполадок при установке с помощью файла Установщика приложений Troubleshoot installation issues with the App Installer file

При возникновении любых проблем с установкой приложения из файла установщика приложения воспользуйтесь советами по диагностике и устранению неполадок из этого раздела. If you find any issues when installing an application from the App Installer file, this topic will provide some troubleshooting guidance that may help.

Предварительные требования Prerequisites

Чтобы иметь возможность загрузки неопубликованных приложений в Windows 10, устройство пользователя должно удовлетворять следующим требованиям: To be able to sideload apps in Windows 10, the user device must satisfy the next requirements:

• На устройстве необходимо включить режим разработчика или загрузку неопубликованных приложений. The device must be enabled for Developer Mode or Sideloading apps. Подробнее об этом см. в разделе Включение устройства для разработки. See Enable your device for development to learn more.
• Сертификат, используемый для подписи пакета, должен быть доверенным сертификатом на устройстве. The certificate used to sign the package must be trusted by the device. См. дополнительные сведения в разделе Доверенные сертификаты ниже. See the Trusted certificates section below for more details.
• Версия Windows 10 должна поддерживать схему файла .appinstaller и протокол распространения. The Windows 10 version must support the .appinstaller file schema and the distribution protocol.

Распространенные проблемы Common issues

Существуют некоторые распространенные проблемы при первой загрузке неопубликованного приложения на машине пользователя. There are some common issues when sideloading an application for first time in the user machine. В следующих разделах описаны наиболее распространенные проблемы и их решения. The next few sections describe the most frequent issues and their solutions.

Версия Windows Windows version

В каждом выпуске Windows 10 повышается удобство загрузки неопубликованных приложений, и в таблице ниже указано, какие функции доступны в каждом основном выпуске. Each Windows 10 release improves on the sideloading experience, in the table below you will find which features are available in each major release. Если вы попытаетесь загрузить неопубликованное приложение, используя метод, который не поддерживается в вашей версии Windows 10, возникнет ошибка развертывания. If you try to sideload an app using a method not supported in your version of Windows 10, you will get a deployment error.

Версия Version	Примечания о загрузке неопубликованных приложений Sideload Notes
Сборка 17134 (обновление от апреля 2018 г., версия 1803) Build 17134 (April 2018 Update, version 1803)	Файл .appinstaller также доступен в папках UNC и общих папках. The .appinstaller file can be accessed over UNC/Share folders. Также доступны настраиваемые проверки обновлений. Configurable update checks are also available.
Сборка 16299 (Fall Creators Update, версия 1709) Build 16299 (Fall Creators Update, version 1709)	Впервые представлен файл .appinstaller , отвечающий за автоматические обновления приложения. Introduced the .appinstaller file to provide automatic updates to your app. Эта версия поддерживает только конечные точки HTTP. This version only supports HTTP endpoints. Проверки обновлений не настраиваются и происходят каждые 24 часа. Update checks are not configurable and happens each 24 hours.
Сборка 15063 (Creators Update, версия 1703) Build 15063 (Creators Update, version 1703)	Установщик приложений может скачивать зависимости приложений (только в режиме выпуска) из Store. The App Installer app is able to download app dependencies (only in release mode) from the Store.
Сборка 14393 (Юбилейное обновление, версия 1607) Build 14393 (Anniversary Update, version 1607)	Представлено приложение «Установщик приложений» для установки файлов .appx и .appxbundle, файл .appinstaller не поддерживается. Introduced the App Installer app to install .appx and .appxbundle files, .appinstaller file is not supported.
Сборка 10586 (ноябрьское обновление, версия 1511) Build 10586 (November Update, version 1511)	Загрузка неопубликованных приложений доступна только через PowerShell с использованием команды Add-AppxPackage. Sideload is only available through PowerShell using the Add-AppxPackage command.
Сборка 10240 (Windows 10, версия 1507) Build 10240 (Windows 10, version 1507)	Загрузка неопубликованных приложений доступна только через PowerShell с использованием команды Add-AppxPackage. Sideload is only available through PowerShell using the Add-AppxPackage command.

Доверенные сертификаты Trusted certificates

Пакеты приложений должны быть подписаны сертификатом, который является доверенным для устройства. App packages must be signed with a certificate that is trusted by the device. Сертификаты, предоставляемые общими центрами сертификации, являются доверенными по умолчанию в операционной системе Windows. Certificates provided by common Certificate Authorities are trusted by default in the Windows operating system.

Однако если сертификат, используемый для подписи пакета приложения, не является доверенным или является локально созданным или самозаверяющим сертификатом, используемым во время разработки, установщик приложения может сообщить о том, что пакет не является доверенным и не позволит установить его. However, if the certificate used to sign an app package is not trusted, or is a locally-generated/self-signed certificate used during development, the app installer may report that the package is untrusted and will prevent it from being installed:

Чтобы решить эту проблему, пользователь с правами локального администратора на устройстве должен использовать средство сертификатов компьютера для импорта сертификата в один из следующих контейнеров: To solve this issue, a user with local administrator rights to the device must use the Computer Certificates tool to import the certificate into one of the following containers:

1. Локальный компьютер: доверенные лица Local Computer: Trusted People
2. Локальный компьютер: доверенные корневые центры (не рекомендуется) Local Computer: Trusted Root Authorities (not recommended)

Не импортируйте сертификаты подписи пакетов в хранилище сертификатов пользователя. Do not import package signing certificates into the User Certificate store. Установщик приложения не выполняет поиск сертификатов пользователей при проверке удостоверения пакета. The App Installer does not search User Certificates when verifying package identity.

Средство управления сертификатами компьютера можно легко найти, выполнив поиск в меню «Пуск»: The Computer Certificates management tool can be easily found by searching from the Start Menu:

После успешного импорта сертификата для подписи повторное выполнение установщика приложения покажет, что пакет является доверенным и может быть установлен: Once the signing certificate is successfully imported, re-running the app installer will show that the package is trusted and can be installed:

Зависимости, которые не устанавливаются Dependencies not installed

Приложения Windows 10 могут иметь зависимости платформы на основе платформы приложений, используемой для создания приложения. Windows 10 applications can have framework dependencies based on the application platform used to generate the app. Если вы используете C# или Visual Basic, приложение потребует среду выполнения .NET и пакеты .NET Framework. If you are using C# or VB, the app will require the .NET Runtime and .NET framework packages. Приложения C++ требуют VCLib. C++ applications require the VCLibs.

Если пакет приложения создан в конфигурации режима выпуска, зависимости платформы будут взяты из Microsoft Store. If the app package is built in Release mode configuration, the framework dependencies will be obtained from the Microsoft Store. Однако если приложение создано в конфигурации режима отладки, зависимости будут получены из местоположения, указанного в файле .appinstaller . However, if the app is built in Debug mode configuration, the dependencies will be obtained from the location specified in the .appinstaller file.

Файл не доступен Files not accessible

При установке из конечной точки HTTP необходимо убедиться, что все файлы доступны с правильным типом MIME. When installing from an HTTP endpoint, it is important to verify that all files are accessible with the correct MIME type. Самый простой способ проверить эти файлы — пройти по ссылкам на странице HTML, созданной Visual Studio. The easiest method to verify these files is by following the links provided in the HTML page generated by Visual Studio. Необходимо проверить эти файлы: You must check these files:

• .appinstaller файл, доступный в виде application/xml .appinstaller file, available as an application/xml
• .appx и .appxbundle файлы, доступные как application/vns.ms-appx .appx and .appxbundle files, available as application/vns.ms-appx

Изоляция проблем установщика приложений Isolate App Installer app issues

Если установщик приложения не может установить приложение, эти действия помогут определить проблемы установки. If the App Installer cannot install the app, these steps will help identify the installation issue.

Проверка установки файла пакета приложения Verify app package file installation

Скачайте файл пакета приложения в локальную папку и попытайтесь установить его с помощью команды PowerShell Add-AppxPackage . Download the app package file to a local folder and try to install it using the Add-AppxPackage PowerShell command.

Скачайте файл .appinstaller и сохраните его в локальную папку. Попробуйте установить его с помощью команды PowerShell Add-AppxPackage -Appinstaller . Download the .appinstaller file to a local folder and try to install it using the Add-AppxPackage -Appinstaller PowerShell command.

Журналы событий установщика приложений App Installer event logs

Инфраструктура развертывания приложений создает журналы, которые часто используются для отладки проблем с установкой с помощью Просмотр событий Windows. Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server The app deployment infrastructure emits logs that are often useful for debugging installation issues via the Windows Event Viewer: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server