Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
What is MXC?
Microsoft Execution Containers (MXC) is an open-source, policy-driven execution technology for running workloads with defined resource permissions. You use the .NET or TypeScript SDK in your app to select a workload, describe what it can access, and run it in a supported containment environment.
Apps, agents, and developer tools often run code that they didn't create or fully control, such as AI-generated commands, third-party tools, and user-provided scripts. Without containment, that code can inherit broad access to files, credentials, network services, and other resources. MXC limits that access to what the task requires.
MXC supports Windows, Linux, and macOS through platform-specific containment backends. A container doesn't necessarily mean a virtual machine or a container image. A workload can run in an operating-system process sandbox, a separate session, or a virtualized environment. For how these models compare, see MXC architecture and containment models.
Windows 365 support
A Cloud PC is a persistent Windows device in Azure. It runs the same operating system, the same applications, and the same management stack as a physical Windows device.
Because of that, MXC process isolation works on a Cloud PC the same way it works on a physical device. Windows 365 adds no isolation mechanism of its own, and nothing about a Cloud PC interferes with process isolation.
What you need
| Requirement | Detail |
|---|---|
| Windows version | Windows 11, version 24H2 or later, with a supported ProcessContainer environment. |
| Cloud PC size | Any supported size. Process isolation doesn't require nested virtualization. |
| SDK (.NET) | .NET 8 SDK or later, and the Microsoft.Mxc.Sdk package from NuGet.org. |
| SDK (TypeScript) | Node.js 18 or later, and the @microsoft/mxc-sdk package from npm. |
| Host app | A trusted app or agent runtime that selects the policy and handles results. |
A supported Windows version doesn't guarantee that every optional feature is available. Check MXC containment options and platform support and address any host-preparation requirements the SDK reports.
Use process isolation on your Cloud PC
Follow these steps on the Cloud PC. They're the same steps as on a physical device.
Step 1: Update Windows
- On the Cloud PC, select Start > Settings > Windows Update.
- Select Check for updates, install any available updates, and restart if you're prompted to.
By SKU:
- Windows 365 Enterprise: set the provisioning policy to a supported Windows version.
- Windows 365 Business, Flex, and Reserve: confirm the Cloud PC is on a supported version.
Step 2: Confirm the backend is available
Query support before you launch a workload, and keep handling errors at launch, because availability can change.
| SDK | Discovery entry point |
|---|---|
| .NET | MxcSandbox.GetPlatformSupport() |
| TypeScript | getPlatformSupport() |
Check that the result reports support and that ProcessContainer appears in the available methods. Treat discovery as advisory, not as a complete policy validator. For details, see Start with runtime discovery.
Step 3: Run a workload
Follow Quickstart: Run a workload with the MXC SDK. The quickstart creates a sample input, allows the workload to read it, grants write access to a separate output folder, and leaves network and UI permissions denied.
Run the quickstart's denied-write case as well. A permitted run that succeeds and a denied run that fails together confirm that the boundary is enforced on your Cloud PC.
Step 4: Author your policy
Start with deny-by-default permissions and add only the resources the task requires. See Author and validate an MXC policy and adapt the MXC policy examples.
To investigate missing access, use Learning Mode, which is supported for Windows ProcessContainer workloads and therefore available on a Cloud PC. Learning Mode provides evidence, not an access decision. Review each observation, then remove all learning and audit settings and run a final enforcing test.
Important
Process isolation runs inside the user's session and doesn't require nested virtualization. Any MXC caller that selects a containment backend above process isolation — such as a session or virtualized environment — does require it. On a Cloud PC, nested virtualization has its own prerequisites. See Set up virtualization-based workloads on your Windows 365 Cloud PC.
Related content
- Microsoft Execution Containers overview
- Quickstart: Run a workload with the MXC SDK
- MXC architecture and containment models
- MXC containment options and platform support
- Author and validate an MXC policy
- Refine an MXC policy with Learning Mode
- MXC release notes
- MXC repository
- What is Windows 365?
- Overview of security concepts in Windows 365
- Set up virtualization-based workloads on your Windows 365 Cloud PC