Skip to content

Commit a085127

Browse files
authored
Merge pull request #228267 from Heidilohr/work-fileshare-bullet
Removing contradictory bullet point.
2 parents 7a2d6a0 + 55f48e0 commit a085127

File tree

1 file changed

+14
-13
lines changed

1 file changed

+14
-13
lines changed

articles/virtual-desktop/app-attach-file-share.md

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
2-
title: Create a file share for MSIX app attach
2+
title: Set up a file share for MSIX app attach
33
titleSuffix: Azure Virtual Desktop
44
description: How to set up a file share for MSIX app attach for Azure Virtual Desktop.
55
author: Heidilohr
66
ms.topic: how-to
7-
ms.date: 12/07/2022
7+
ms.date: 03/22/2023
88
ms.author: helohr
99
manager: femila
1010
---
11-
# Create a file share for MSIX app attach
11+
# Set up a file share for MSIX app attach
1212

13-
When a user in a host pool accesses MSIX images, they must be stored in a network share with read-only permissions. In the how-to, you'll learn the steps needed to set up a file share for MSIX app attach.
13+
For a user to access MSIX images, the images must be stored on a network share. In this article, you'll learn how to set up a file share for MSIX app attach.
1414

1515
MSIX app attach doesn't have dependencies on the type of storage fabric the file share uses. The considerations for the MSIX app attach share are same as the considerations for an FSLogix share. To learn more about storage requirements, see [Storage options for FSLogix profile containers in Azure Virtual Desktop](store-fslogix-profile.md).
1616

@@ -45,26 +45,27 @@ Here are some other things we recommend you do to optimize MSIX app attach perfo
4545

4646
- `<MSIXAppAttachFileShare\>\*.VHD`
4747
- `<MSIXAppAttachFileShare\>\*.VHDX`
48+
- `<MSIXAppAttachFileShare>.CIM`
49+
50+
- If you're using Azure Files, exclude the following locations from antivirus scans:
51+
4852
- `\\storageaccount.file.core.windows.net\share*.VHD`
4953
- `\\storageaccount.file.core.windows.net\share*.VHDX`
50-
- `<MSIXAppAttachFileShare>.CIM`
5154
- `\\storageaccount.file.core.windows.net\share**.CIM`
5255

5356
- Separate the storage fabrics for MSIX app attach from FSLogix profile containers.
54-
- All VM system accounts and user accounts must have read-only permissions to access the file share.
5557
- Any disaster recovery plans for Azure Virtual Desktop must include replicating the MSIX app attach file share in your secondary failover location. To learn more about disaster recovery, see [Set up a business continuity and disaster recovery plan](disaster-recovery.md). You'll also need to ensure your file share path is accessible in the secondary location. You can use [Distributed File System (DFS) Namespaces](/windows-server/storage/dfs-namespaces/dfs-overview) to provide a single share name across different file shares.
5658

57-
## File share creation
59+
## Configure file share permissions when using Azure Files
5860

59-
The setup process for MSIX app attach file share is largely the same as [the setup process for FSLogix profile file shares](create-host-pools-user-profile.md). However, you'll need to assign users different permissions. MSIX app attach requires read-only permissions to access the file share.
61+
The setup process for MSIX app attach file share is largely the same as [the setup process for FSLogix profile file shares](create-host-pools-user-profile.md). However, you'll need to assign different permissions. MSIX app attach requires read-only permissions using the computer account of each session host to access the file share.
6062

61-
If you're storing your MSIX applications in Azure Files, then for your session hosts, you'll need to assign all session hosts VMs both storage account role-based access permissions and file share New Technology File System (NTFS) permissions on the share.
63+
When you store your MSIX applications in Azure Files, you must assign all session host VMs both storage account role-based access permissions and file share New Technology File System (NTFS) permissions on the share.
6264

6365
| Azure object | Required role | Role function |
6466
|-----------------------------------|--------------------------------------------------|-----------------------------------------------|
65-
| Session hosts (VM computer objects)| Storage File Data SMB Share Reader | Allows for read access to Azure File Share over SMB |
66-
| Admins on File Share | Storage File Data SMB Share Elevated Contributor | Full control |
67-
| Users on File Share | Storage File Data SMB Share Contributor | Read and Execute, Read, List folder contents |
67+
| Session hosts (VM computer objects)| [Storage File Data SMB Share Reader](../role-based-access-control/built-in-roles.md#storage-file-data-smb-share-reader) | Allows for read access to Azure File Share over SMB |
68+
| Admins on File Share | [Storage File Data SMB Share Elevated Contributor](../role-based-access-control/built-in-roles.md#storage-file-data-smb-share-elevated-contributor) | Allows for read, write, delete, and modify ACLs on files and directories in Azure File Shares |
6869

6970
To assign session hosts VMs permissions for the storage account and file share:
7071

@@ -80,7 +81,7 @@ To assign session hosts VMs permissions for the storage account and file share:
8081

8182
6. Join the storage account to AD DS by following the instructions in [Part one: enable AD DS authentication for your Azure file shares](../storage/files/storage-files-identity-ad-ds-enable.md#option-one-recommended-use-azfileshybrid-powershell-module).
8283

83-
7. Assign the synced AD DS group the Storage File Data SMB Share Reader role on the storage account .
84+
7. Assign the synced AD DS group the Storage File Data SMB Share Reader role on the storage account.
8485

8586
8. Mount the file share to any session host by following the instructions in [Part two: assign share-level permissions to an identity](../storage/files/storage-files-identity-ad-ds-assign-permissions.md).
8687

0 commit comments

Comments
 (0)