Skip to content

Commit 2a929cc

Browse files
authored
Update storage-sync-cloud-tiering.md
Updated Invoke-StorageSyncFileRecall section
1 parent 3702e22 commit 2a929cc

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

articles/storage/files/storage-sync-cloud-tiering.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,9 +97,18 @@ You also can use PowerShell to force a file to be recalled. This option might be
9797
9898
```powershell
9999
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
100-
Invoke-StorageSyncFileRecall -Path <file-or-directory-to-be-recalled>
100+
Invoke-StorageSyncFileRecall -Path <path-to-to-your-server-endpoint> -Order CloudTieringPolicy
101101
```
102102

103+
Specifying `-Order CloudTieringPolicy` will recall the most recently modified files first.
104+
Other optional parameters:
105+
* `-ThreadCount` determines how many files can be recalled in parallel.
106+
* `-PerFileRetryCount`determines how often a recall will be attempted of a file that is currently blocked.
107+
* `-PerFileRetryDelaySeconds`determines the time in seconds between retry to recall attempts and should always be used in combination with the previous parameter.
108+
109+
> [!Note]
110+
> If the local volume hosting the server does not have enough free space to recall all the tiered data, the `Invoke-StorageSyncFileRecall` cmdlet fails.
111+
103112
<a id="sizeondisk-versus-size"></a>
104113
### Why doesn't the *Size on disk* property for a file match the *Size* property after using Azure File Sync?
105114
Windows File Explorer exposes two properties to represent the size of a file: **Size** and **Size on disk**. These properties differ subtly in meaning. **Size** represents the complete size of the file. **Size on disk** represents the size of the file stream that's stored on the disk. The values for these properties can differ for a variety of reasons, such as compression, use of Data Deduplication, or cloud tiering with Azure File Sync. If a file is tiered to an Azure file share, the size on the disk is zero, because the file stream is stored in your Azure file share, and not on the disk. It's also possible for a file to be partially tiered (or partially recalled). In a partially tiered file, part of the file is on disk. This might occur when files are partially read by applications like multimedia players or zip utilities.

0 commit comments

Comments
 (0)