Skip to content

Commit 05664ea

Browse files
authored
Update file-sync-how-to-manage-tiered-files.md
1 parent 37312f9 commit 05664ea

File tree

1 file changed

+20
-14
lines changed

1 file changed

+20
-14
lines changed

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

Lines changed: 20 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Tips and PowerShell commandlets to help you manage tiered files
44
author: khdownie
55
ms.service: storage
66
ms.topic: how-to
7-
ms.date: 06/03/2022
7+
ms.date: 06/06/2022
88
ms.author: kendownie
99
ms.subservice: files
1010
---
@@ -59,33 +59,39 @@ There are several ways to check whether a file has been tiered to your Azure fil
5959

6060
## How to exclude files or folders from being tiered
6161

62-
If you want files or folders to be excluded from tiering 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.
62+
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.
6363

64-
To exclude files or folders from tiering, perform the following steps:
64+
To exclude files or folders from cloud tiering, perform the following steps:
6565
1. Open an elevated command prompt.
6666
2. Run one of the following commands to configure exclusions:
6767

6868
To exclude certain file extensions from tiering (for example, .one, .lnk, .log), run the following command:
69-
reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d .one|.lnk|.log /f
69+
**reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d .one|.lnk|.log /f**
7070

7171
To exclude a specific file name from tiering (for example, FileName.vhd), run the following command:
72-
reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d FileName.vhd /f
72+
**reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d FileName.vhd /f**
7373

7474
To exclude all files under a folder from tiering (for example, D:\ShareRoot\Folder\SubFolder), run the following command:
75-
reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d D:\\ShareRoot\\Folder\\SubFolder /f
75+
**reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d D:\\\\ShareRoot\\\\Folder\\\\SubFolder /f**
7676

7777
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:
78-
reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d D:\\ShareRoot\\Folder1\\SubFolder1|FileName.log|.txt /f
78+
**reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d D:\\\\ShareRoot\\\\Folder1\\\\SubFolder1|FileName.log|.txt /f**
7979

80-
3. For the exclusions to take effect, you must restart the Storage Sync Agent service (FileSyncSvc) by running the following commands:
81-
net stop filesyncsvc
82-
net start filesyncsvc
80+
3. For the cloud tiering exclusions to take effect, you must restart the Storage Sync Agent service (FileSyncSvc) by running the following commands:
81+
**net stop filesyncsvc**
82+
83+
**net start filesyncsvc**
8384

8485
### More information
85-
- Each exclusion pattern in the registry should be separated by a pipe (|) character.
86-
- File name or file type exclusions apply to all server endpoints on the server.
87-
- Exclusions do not apply to files already tiered. Use the Invoke-StorageSyncFileRecall cmdlet to recall files already tiered.
88-
- You cannot exclude file types from a particular folder only.
86+
- 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.
87+
- Example: **reg ADD "HKEY_LOCAL_MACHINE\Cluster\StorageSync\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d .one|.lnk|.log /f**
88+
- Each exclusion in the registry should be separated by a pipe (|) character.
89+
- Use double backslash (\\\\) when specifying a path to exclude.
90+
- Example: **reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d D:\\\\ShareRoot\\\\Folder\\\\SubFolder /f**
91+
- File name or file type exclusions apply to all server endpoints on the server.
92+
- You cannot exclude file types from a particular folder only.
93+
- 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.
94+
- 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.
8995

9096
## How to exclude applications from cloud tiering last access time tracking
9197

0 commit comments

Comments
 (0)