You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/virtual-desktop/app-attach.md
+12-17Lines changed: 12 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,9 +19,18 @@ Before you can use MSIX app attach to follow the directions in this article, you
19
19
20
20
- A Windows 10 or 11 client.
21
21
- An application you've expanded from MSIX format into app attach format. To learn how to expand an MSIX application, see [Using the MSIXMGR tool](app-attach-msixmgr.md).
22
+
- If you're using a cimFS image, you'll need to install the following module before you can get started:
23
+
24
+
```powershell
25
+
Install-Module CimDiskImage
26
+
Import-Module CimDiskImage
27
+
```
22
28
23
29
These instructions don't require an Azure Virtual Desktop deployment because they describe a process for testing outside of Azure Virtual Desktop.
24
30
31
+
>[!NOTE]
32
+
>Microsoft Support doesn't currently support the PowerShell scripts in this article, so if you run into any problems, you'll need to submit a request on [the module's Github repository](https://github.com/Azure/RDS-Templates/tree/master/msix-app-attach).
33
+
25
34
## Phases of MSIX app attach
26
35
27
36
To use MSIX packages outside of Azure Virtual Desktop, there are four distinct phases that you must perform in the following order, otherwise it won't work:
@@ -31,7 +40,7 @@ To use MSIX packages outside of Azure Virtual Desktop, there are four distinct p
31
40
3. Deregister
32
41
4. Destage
33
42
34
-
Staging and destaging are machine-level operations, while registering and deregistering are user-level operations. The commands you'll need to use will vary based on which version of PowerShell you're using and whether your disk images are in *cim* or *VHD(X)* format.
43
+
Staging and destaging are machine-level operations, while registering and deregistering are user-level operations. The commands you'll need to use will vary based on which version of PowerShell you're using and whether your disk images are in *CimFS* or *VHD(X)* format.
35
44
36
45
>[!NOTE]
37
46
>All MSIX application packages include a certificate. You're responsible for making sure the certificates for MSIX applications are trusted in your environment.
@@ -40,22 +49,11 @@ Staging and destaging are machine-level operations, while registering and deregi
40
49
41
50
The staging script prepares your machine to receive the MSIX package and mounts the relevant package to your machine. You'll only need to run the following commands once per machine.
42
51
43
-
However, if you're using an image in cim format or a version of PowerShell greater than 5.1, the instructions will look a bit different. Later versions of PowerShell are multi-platform, which means the Windows application parts are split off into their own package called [Windows Runtime](/windows/uwp/winrt-components/). You'll need to use a slightly different version of the commands to install a package with a multi-platform version of PowerShell.
52
+
However, if you're using an image in CimFS format or a version of PowerShell greater than 5.1, the instructions will look a bit different. Later versions of PowerShell are multi-platform, which means the Windows application parts are split off into their own package called [Windows Runtime](/windows/uwp/winrt-components/). You'll need to use a slightly different version of the commands to install a package with a multi-platform version of PowerShell.
44
53
45
54
You'll need to run PowerShell as an Administrator to run the commands in the following sections.
46
55
47
-
Next, you'll need to decide which instructions you need to follow to stage your package based on which version of PowerShell you're using and whether your disk image is in *cim* or *VHD(X)* format.
48
-
49
-
### CimFS
50
-
51
-
If your disk image is in VHD(X) format, ignore this section and skip ahead to either [PowerShell 6 and later](#powershell-6-and-later) or [PowerShell 5.1 and earlier](#powershell-51-and-earlier), depending on which version of PowerShell you're using.
52
-
53
-
If your disk image is in the [CimFS](/windows/win32/api/_cimfs/) format, you'll need run the following cmdlets to install a PowerShell module from the PowerShell image gallery in order to use the commands in this article.
54
-
55
-
```powershell
56
-
Install-Module CimDiskImage
57
-
Import-Module CimDiskImage
58
-
```
56
+
Next, you'll need to decide which instructions you need to follow to stage your package based on which version of PowerShell you're using.
59
57
60
58
### PowerShell 6 and later
61
59
@@ -92,9 +90,6 @@ To stage packages at boot with PowerShell version 5.1 or earlier, run this comma
>Microsoft Support doesn't currently support this module, so if you run into any problems, you'll need to submit a request on [the module's Github repository](https://github.com/Azure/RDS-Templates/tree/master/msix-app-attach).
97
-
98
93
## Mount your disk image
99
94
100
95
Now that you've prepared your machine to stage MSIX app attach packages, you'll need to mount your disk image. This process will vary depending on whether you're using the *VHD(X)* or *CimFs* format for your disk image.
0 commit comments