Skip to content

Commit 84bd3bd

Browse files
committed
Updates based on feedback.
1 parent 1cf557b commit 84bd3bd

File tree

2 files changed

+13
-18
lines changed

2 files changed

+13
-18
lines changed

articles/virtual-desktop/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -295,7 +295,7 @@
295295
href: app-attach-azure-portal.md
296296
- name: Set up MSIX app attach with PowerShell
297297
href: app-attach-powershell.md
298-
- name: Test and troubleshoot packages with MSIX app attach
298+
- name: Test and troubleshoot packages
299299
href: app-attach.md
300300
- name: Prepare an MSIX image
301301
href: app-attach-image-prep.md

articles/virtual-desktop/app-attach.md

Lines changed: 12 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,18 @@ Before you can use MSIX app attach to follow the directions in this article, you
1919

2020
- A Windows 10 or 11 client.
2121
- 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+
```
2228

2329
These instructions don't require an Azure Virtual Desktop deployment because they describe a process for testing outside of Azure Virtual Desktop.
2430

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+
2534
## Phases of MSIX app attach
2635

2736
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
3140
3. Deregister
3241
4. Destage
3342

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.
3544

3645
>[!NOTE]
3746
>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
4049

4150
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.
4251

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.
4453

4554
You'll need to run PowerShell as an Administrator to run the commands in the following sections.
4655

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.
5957

6058
### PowerShell 6 and later
6159

@@ -92,9 +90,6 @@ To stage packages at boot with PowerShell version 5.1 or earlier, run this comma
9290
Add-Type -AssemblyName System.Runtime.WindowsRuntime
9391
```
9492

95-
>[!NOTE]
96-
>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-
9893
## Mount your disk image
9994

10095
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

Comments
 (0)