Merge pull request #200462 from jeffpatt24/patch-1

Update file-sync-how-to-manage-tiered-files.md

Author: denrea

articles/storage/file-sync/file-sync-how-to-manage-tiered-files.md

@@ -4,7 +4,7 @@ description: Tips and PowerShell commandlets to help you manage tiered files
 author: khdownie
 ms.service: storage
 ms.topic: how-to
-ms.date: 04/13/2021
+ms.date: 06/06/2022
 ms.author: kendownie
 ms.subservice: files
 ---
@@ -57,6 +57,42 @@ There are several ways to check whether a file has been tiered to your Azure fil
         > [!WARNING]
         > The `fsutil reparsepoint` utility command also has the ability to delete a reparse point. Do not execute this command unless the Azure File Sync engineering team asks you to. Running this command might result in data loss.
 
+## How to exclude files or folders from being tiered
+
+If you want to exclude files or folders from being tiered and remain local on the Windows Server, you can configure the GhostingExclusionList registry setting. You can exclude files by file name, file extension or path. 
+
+To exclude files or folders from cloud tiering, perform the following steps:
+1. Open an elevated command prompt.
+2. Run one of the following commands to configure exclusions:
+
+	To exclude certain file extensions from tiering (for example, .one, .lnk, .log), run the following command:  
+	**reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList  /t REG_SZ /d .one|.lnk|.log /f**
+
+	To exclude a specific file name from tiering (for example, FileName.vhd), run the following command:  
+	**reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList  /t REG_SZ /d FileName.vhd /f**
+
+	To exclude all files under a folder from tiering (for example, D:\ShareRoot\Folder\SubFolder), run the following command:   
+	**reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList  /t REG_SZ /d D:\\\\ShareRoot\\\\Folder\\\\SubFolder /f**
+
+	To exclude a combination of file names, file extensions and folders from tiering (for example, D:\ShareRoot\Folder1\SubFolder1,FileName.log,.txt), run the following command:  
+	**reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList  /t REG_SZ /d D:\\\\ShareRoot\\\\Folder1\\\\SubFolder1|FileName.log|.txt /f** 
+
+3. For the cloud tiering exclusions to take effect, you must restart the Storage Sync Agent service (FileSyncSvc) by running the following commands:  
+	**net stop filesyncsvc**  
+	
+	**net start filesyncsvc**
+
+### More information
+-  If the Azure File Sync agent is installed on a Failover Cluster, the GhostingExclusionList registry setting must be created under HKEY_LOCAL_MACHINE\Cluster\StorageSync\SOFTWARE\Microsoft\Azure\StorageSync.
+	-  Example: **reg ADD "HKEY_LOCAL_MACHINE\Cluster\StorageSync\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d .one|.lnk|.log /f**
+-  Each exclusion in the registry should be separated by a pipe (|) character.
+-  Use double backslash (\\\\) when specifying a path to exclude.
+	-  Example: **reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList  /t REG_SZ /d D:\\\\ShareRoot\\\\Folder\\\\SubFolder /f**
+-  File name or file type exclusions apply to all server endpoints on the server.
+-  You cannot exclude file types from a particular folder only.
+-  Exclusions do not apply to files already tiered. Use the [Invoke-StorageSyncFileRecall](#how-to-recall-a-tiered-file-to-disk) cmdlet to recall files already tiered.
+-  Use Event ID 9001 in the Telemetry event log on the server to check the cloud tiering exclusions that are configured. The Telemetry event log is located in Event Viewer under Applications and Services\Microsoft\FileSync\Agent.
+
 ## How to exclude applications from cloud tiering last access time tracking
 
 When an application accesses a file, the last access time for the file is updated in the cloud tiering database. Applications that scan the file system like anti-virus cause all files to have the same last access time, which impacts when files are tiered.