diff --git a/msix-src/desktop/managing-your-msix-deployment-targetdevices.md b/msix-src/desktop/managing-your-msix-deployment-targetdevices.md index d7a572f8..a8770d60 100644 --- a/msix-src/desktop/managing-your-msix-deployment-targetdevices.md +++ b/msix-src/desktop/managing-your-msix-deployment-targetdevices.md @@ -1,7 +1,7 @@ --- description: This article provides details that need to be considered when deploying your MSIX packages on Windows devices in an enterprise environment. This article is targeted at enterprise and IT Pros. title: Plan for your deployment. -ms.date: 02/16/2021 +ms.date: 08/25/2026 ms.topic: article keywords: windows 10, deployment, msix ms.assetid: @@ -17,7 +17,12 @@ All developers also need to know the minimum supported operating system they wan MSIX was introduced to Windows 10 version 1709 (10.0.16299.0) and greater. This means if you are using the basic MSIX functionality and targeting Windows 10 version 1709 or greater, it will just work. For a complete list of supporting operating systems and supporting features, see [Supported Platforms.](../supported-platforms.md) ## Services packaged in MSIX -The ability to package services in MSIX were introduced in Windows 10 Client 2004 (10.0.19041.0) and greater. Therefore if your application is using services packaged in MSIX it is limited to deployment on those operating systems. Admin privileges are required for installation due to the fact that a service may start in the background and make changes to the machine. To learn more about using MSIX Package Services in MSIX, see [Convert an installer that includes services.](../packaging-tool/convert-an-installer-with-services.md) + +The ability to package services in MSIX was introduced in Windows 10 Client 2004 +(10.0.19041.0) and later. If your MSIX package contains a Windows service, limit +package deployment to those operating systems. Installing the package requires +administrator privileges; for the reason and deployment consequences, see +[Convert an installer that includes services][convert-services]. ## Server support for MSIX Packages MSIX is not built into Windows Server. MSIX is however supported on Window 10 Server with Desktop Experience builds 1709 and greater when [AppInstaller application](https://www.microsoft.com/p/app-installer/9nblggh4nns1) is installed. If you are targeting earlier builds of the server, you must also install MSIX Core. For information on MSIX Core, see [MSIX Core.](../msix-core/msixcore.md) @@ -66,3 +71,5 @@ Also, consider adding code to your packaged application that accomplishes these For more information and examples, see [Transition users to your app](/windows/apps/desktop/modernize/desktop-to-uwp-distribute#transition-users-to-your-packaged-app). +[convert-services]: ../packaging-tool/convert-an-installer-with-services.md + diff --git a/msix-src/packaging-tool/convert-an-installer-with-services.md b/msix-src/packaging-tool/convert-an-installer-with-services.md index 5550f85e..65e63c07 100644 --- a/msix-src/packaging-tool/convert-an-installer-with-services.md +++ b/msix-src/packaging-tool/convert-an-installer-with-services.md @@ -1,14 +1,23 @@ --- title: Converting an installer with services description: This article explains how to convert an existing installer with services to MSIX using the MSIX Packaging Tool -ms.date: 12/19/2019 +ms.date: 08/25/2026 ms.topic: concept-article keywords: windows 10, MSIX, MSIX Packaging Tool, services --- # Convert an installer that includes services -Windows 10, version 2004, introduces support for running an MSIX package that includes services. You can use the MSIX Packaging Tool to take an existing installer with services and convert it to MSIX. This support is as of the January 2020 release of the [MSIX Packaging Tool](tool-overview.md)(1.2019.1220.0). Once you have a packaged MSIX with a service, it will require admin privileges to install on a machine. +Windows 10, version 2004, introduces support for running an MSIX package that includes services. You can use the MSIX Packaging Tool to take an existing installer with services and convert it to MSIX. This support is as of the January 2020 release of the [MSIX Packaging Tool](tool-overview.md)(1.2019.1220.0). + +> [!IMPORTANT] +> When an MSIX package that contains a Windows service is installed, Windows registers +> the service in the [Service Control Manager (SCM) database][scm-database]. Creating +> a service requires `SC_MANAGER_CREATE_SERVICE` access to the SCM. By default, the +> [SCM security descriptor][scm-access-rights] grants this access to administrators. +> The SCM security descriptor governs access and can be modified, so administrator +> privileges aren't an absolute requirement. With the default SCM security +> descriptor, however, installing the package requires elevation. ## Instructions @@ -40,3 +49,6 @@ We currently do not support services with dependencies outside the package. ## Add a service manually using your manifest If you are manually adding a service to your application, you will need to [add a service](/uwp/schemas/appxpackage/uapmanifestschema/element-desktop6-service) to your app manifest. This does require a [restricted capability](/windows/uwp/packaging/app-capability-declarations#restricted-capabilities) to add to your application. + +[scm-access-rights]: /windows/win32/services/service-security-and-access-rights +[scm-database]: /windows/win32/services/database-of-installed-services