Merge pull request #172875 from Heidilohr/work-files-link

Replacing outdated text in profile containers article

Author: v-ccolin

articles/virtual-desktop/create-file-share.md

@@ -3,7 +3,7 @@ title: Create an Azure Files file share with a domain controller - Azure
 description: Set up an FSLogix profile container on an Azure file share in an existing Azure Virtual Desktop host pool with your Active Directory domain.
 author: Heidilohr
 ms.topic: how-to
-ms.date: 06/05/2020
+ms.date: 12/08/2021
 ms.author: helohr
 manager: femila
 ---
@@ -192,7 +192,7 @@ To configure FSLogix on your session host VM:
 
 2. [Download and install FSLogix](/fslogix/install-ht).
 
-5. Follow the instructions in [Configure profile container registry settings](/fslogix/configure-profile-container-tutorial#configure-profile-container-registry-settings):
+3. Follow the instructions in [Configure profile container registry settings](/fslogix/configure-profile-container-tutorial#configure-profile-container-registry-settings):
 
     - Navigate to **Computer** > **HKEY_LOCAL_MACHINE** > **SOFTWARE** > **FSLogix**.
 
@@ -204,7 +204,7 @@ To configure FSLogix on your session host VM:
 
     - Set the value of **VHDLocations** to the UNC path you generated in [Get the UNC path](#get-the-unc-path).
 
-6. Restart the VM.
+4. Restart the VM.
 
 ## Testing
 

articles/virtual-desktop/create-profile-container-adds.md

@@ -3,7 +3,7 @@ title: Create FSLogix profile container Azure Files Active Directory Domain Serv
 description: This article describes how to create an FSLogix profile container with Azure Files and Azure Active Directory Domain Services.
 author: Heidilohr
 ms.topic: how-to
-ms.date: 04/09/2021
+ms.date: 12/08/2021
 ms.author: helohr
 manager: femila
 ---
@@ -18,19 +18,19 @@ This article assumes you've already set up an Azure AD DS instance. If you don't
 
 ## Add Azure AD DS admins
 
-To add additional admins, you create a new user and grant them permissions.
+To add more admins, you must create a new user and grant them the necessary permissions.
 
 To add an admin:
 
 1. Select **Azure Active Directory** from the sidebar, then select **All users**, and then select **New user**.
 
-2.  Enter the user details into the fields.
+2. Enter the user details into the fields.
 
 3. In the Azure Active Directory pane on the left side of the screen, select **Groups**.
 
 4. Select the **AAD DC Administrators** group.
 
-5. In the left pane, select **Members**, then select **Add members** in the main pane. This will show a list of all users available in Azure AD. Select the name of the user profile you just created.
+5. In the pane on the left side of the window, select **Members**, then select **Add members** in the main pane. You will see a list of all available users in Azure AD. Select the name of the user profile you just created.
 
 ## Set up an Azure Storage account
 
@@ -76,20 +76,18 @@ To get the Storage Account access key:
 
 1. From the Azure portal sidebar, select **Storage accounts**.
 
-2. From the list of storage accounts, select the account for which you enabled Azure AD DS and created the custom roles in steps above.
+2. From the list of storage accounts, select the account that you enabled Azure AD DS and created the custom roles for in the previous sections.
 
 3. Under **Settings**, select **Access keys** and copy the key from **key1**.
 
 4. Go to the **Virtual Machines** tab and locate any VM that will become part of your host pool.
 
-5. Select the name of the virtual machine (VM) under **Virtual Machines (adVM)** and select **Connect**
-
-    This will download an RDP file that will let you sign in to the VM with its own credentials.
+5. Select the name of the virtual machine (VM) under **Virtual Machines (adVM)** and select **Connect**. Connecting will download an RDP file that will let you sign in to the VM with its own credentials.
 
     > [!div class="mx-imgBorder"]
     > ![A screenshot of the RDP tab of the Connect to virtual machine window.](media/rdp-tab.png)
 
-6. When you've signed in to the VM, run a command prompt as an administrator.
+6. When you've signed in to the VM, open a command prompt as an administrator.
 
 7. Run the following command:
 
@@ -129,111 +127,49 @@ To get the Storage Account access key:
      icacls <mounted-drive-letter>: /remove "Builtin\Users"
      ```
 
-## Create a profile container
-
-Now that your profiles are ready to go, let's create a FSLogix profile container.
-
-To configure a FSLogix profile container:
-
-1. Sign in to the session host VM you configured at the beginning of this article, then [download and install the FSLogix agent](/fslogix/install-ht/).
-
-2. Unzip the FSLogix agent file you downloaded and go to **x64** > **Releases**, then open **FSLogixAppsSetup.exe**.
-
-3. Once the installer launches, select **I agree to the license terms and conditions.** If applicable, provide a new key.
-
-4. Select **Install**.
-
-5. Open **Drive C**, then go to **Program Files** > **FSLogix** > **Apps** to make sure the FSLogix agent was properly installed.
-
-     >[!NOTE]
-     > If there are multiple VMs in the host pool, you'll need to repeat steps 1 through 5 for each VM.
-
-6. Run **Registry Editor** (RegEdit) as an administrator.
-
-7. Navigate to **Computer** > **HKEY_LOCAL_MACHINE** > **software** > **FSLogix**, right-click on **FSLogix**, select **New**, and then select **Key**.
-
-8. Create a new key named **Profiles**.
-
-9.  Right-click on **Profiles**, select **New**, and then select **DWORD (32-bit) Value.** Name the value **Enabled** and set the **Data** value to **1**.
-
-    > [!div class="mx-imgBorder"]
-    > ![A screenshot of the Profiles key. The REG_DWORD file is highlighted and its Data value is set to 1.](media/dword-value.png)
-
-10. Right-click on **Profiles**, select **New**, and then select **Multi-String Value**. Name the value **VHDLocations** and set enter the URI for the Azure Files share `\\fsprofile.file.core.windows.net\share` as the Data value.
+## Create a profile container with FSLogix
 
-    > [!div class="mx-imgBorder"]
-    > ![A screenshot of the Profiles key showing the VHDLocations file. Its Data value shows the URI for the Azure Files share.](media/multi-string-value.png)
-
-## Assign users to a session host
-
-Now you'll need to assign users to your session host.
-
-To assign users:
-
-1. Run Windows PowerShell as an administrator, then run the following cmdlet to sign in to Azure Virtual Desktop with PowerShell:
-
-   ```powershell
-   Import-Module Microsoft.RdInfra.RdPowershell
-
-   #Optional
-   Install-Module Microsoft.RdInfra.RdPowershell
-
-   $brokerurl = "https://rdbroker.wvd.microsoft.com"
+In order to use profile containers, you'll need to configure FSLogix on your session host VMs. If you're using a custom image that doesn't have the FSLogix Agent already installed, follow the instructions in [Download and install FSLogix](/fslogix/install-ht). You can set options for setting registry keys on session hosts in images or on a group policy. You'll need to follow these instructions every time you configure a session host, as long as you don't use group policies to apply these settings at scale to multiple session hosts.
 
-   Add-RdsAccount -DeploymentUrl $brokerurl
-   ```
+To configure FSLogix on your session host VM:
 
-   When prompted for credentials, enter the same user that was granted the TenantCreator, RDS Owner, or RDS Contributor role on the Azure Virtual Desktop tenant.
+1. RDP to the session host VM of the Azure Virtual Desktop host pool.
 
-2. Run the following cmdlets to assign the user to the remote desktop group:
+2. [Download and install FSLogix](/fslogix/install-ht).
 
-     ```powershell
-     $tenant = "<your-wvd-tenant>"
+3. Follow the instructions in [Configure profile container registry settings](/fslogix/configure-profile-container-tutorial#configure-profile-container-registry-settings):
 
-     $pool1 = "<wvd-pool>"
+    - Go to **Computer** > **HKEY_LOCAL_MACHINE** > **SOFTWARE** > **FSLogix**.
 
-     $appgroup = "Desktop Application Group"
+    - Create a **Profiles** key.
 
-     $user1 = "<user-principal>"
+    - Create **Enabled, DWORD** with a value of 1.
 
-     Add-RdsAppGroupUser $tenant $pool1 $appgroup $user1
-     ```
-
-    Like the earlier cmdlets, make sure to replace `<your-wvd-tenant>`, `<wvd-pool>`, and `<user-principal>` with the relevant values.
-
-    For example:
+    - Create **VHDLocations, MULTI_SZ**.
 
-     ```powershell
-     $pool1 = "contoso"
+    - [Get the UNC path](create-file-share.md#get-the-unc-path), then set the value of **VHDLocations** to that UNC path.
 
-     $tenant = "contoso"
-
-     $appgroup = "Desktop Application Group"
-
-     $user1 = "[email protected]"
-
-     Add-RdsAppGroupUser $tenant $pool1 $appgroup $user1
-     ```
+4. Restart the VM.
 
 ## Make sure your profile works
 
-Now all you have to do is make sure the profile you created exists and works as intended.
+Once you've installed and configured FSLogix, you can test your deployment by signing in with a user account that's been assigned an app group or desktop on the host pool. Make sure the user account you sign in with has permission on the file share.
 
-To verify your profile:
+If the user has signed in before, they'll have an existing local profile that they'll use during this session. To avoid creating a local profile, either create a new user account to use for tests or use the configuration methods described in [Tutorial: Configure Profile Container to redirect User Profiles](/fslogix/configure-profile-container-tutorial/).
 
-1. Open a browser and go to [the Azure Virtual Desktop web client](https://rdweb.wvd.microsoft.com/arm/webclient).
+To check your permissions on your session:
 
-2. Sign in with the user account assigned to the Remote Desktop group.
+1. Start a session on Azure Virtual Desktop.
 
-3. Once the user session has been established, open the Azure portal and sign in with an administrative account.
+2. Open the Azure portal.
 
-4. From the sidebar, select **Storage accounts**.
+3. Open the storage account you created in [Set up a storage account](#set-up-an-azure-storage-account).
 
-5. Select the storage account you configured as the file share for your session host pool and enabled with Azure AD DS.
+4. Go to **Data storage** in your storage account, then select **File shares**.
 
-6. Select the **Files** icon, then expand your share.
+5. Open your file share and make sure the user profile folder you've created is in there.
 
-    If everything's set up correctly, you should see a **Directory** with a name that's formatted like this: `<user SID>-<username>`.
+For extra testing, follow the instructions in [Make sure your profile works](create-profile-container-adds.md#make-sure-your-profile-works).
 
 ## Next steps