You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The **Update-DedupStatus** cmdlet scans one or more specified volumes to compute fresh data deduplication savings information.
25
-
This cmdlet returns a **DeduplicationStatus** object.
26
-
For quick access to cached metadata use **Get-DedupStatus**.
27
-
When this cmdlet is run on multiple volumes with one cmdlet call, the analysis for each volume is done serially.
28
24
29
-
Note: On large volumes this cmdlet can run for several minutes and will always perform a rescan after the initial scan.
30
-
The default behavior is to wait for completion, regardless of the length of time required to run the scan and rescan.
25
+
The `Update-DedupStatus` cmdlet scans one or more specified volumes to compute fresh data
26
+
deduplication savings information. This cmdlet returns a **DeduplicationStatus** object. For quick
27
+
access to cached metadata use `Get-DedupStatus`. When this cmdlet is run on multiple volumes with
28
+
one cmdlet call, the analysis for each volume is done serially.
29
+
30
+
> [!NOTE]
31
+
> On large volumes this cmdlet can run for several minutes and will always perform a rescan after
32
+
> the initial scan. The default behavior is to wait for completion, regardless of the length of
33
+
> time required to run the scan and rescan.
31
34
32
35
To run this cmdlet, you must start Windows PowerShell® with the **Run as administrator** option.
33
36
34
-
This cmdlet returns the following metadata:
35
-
36
-
- DedupSavedSpace.
37
-
Saved space is the difference between the logical size of the optimized files and the logical size of the store.
38
-
This is the deduplicated user data plus data deduplication metadata.
39
-
This number changes continually.
40
-
- DedupRate.
41
-
Data deduplication rate is the ratio of data deduplication saved space to the logical size of all of the files on the volume and is expressed in percentage.
42
-
This number will change continually.
43
-
- OptimizedFilesCount.
44
-
Optimized files count is the number of optimized files on the specified volume.
45
-
This number remains steady, instead of decreasing, as users delete files from, or add files to, the volume, until a garbage collection job is run.
46
-
This count is most accurate after a garbage collection job runs.
47
-
- OptimizedFilesSize.
48
-
Optimized files size is the aggregate size of all optimized files on the specified volume.
49
-
This number remains steady, instead of decreasing, as users delete files from, or add new files to, the volume, until a garbage collection job is run.
50
-
This number is most accurate after a garbage collection job runs.
51
-
- InPolicyFilesCount.
52
-
In policy files count is the number of files that currently qualify for optimization.
53
-
This number stays relatively constant between optimization jobs.
54
-
- InPolicyFilesSize.
55
-
In policy files size is the aggregate size of all files that currently qualify for optimization.
56
-
This number stays relatively constant between optimization jobs.
57
-
- LastOptimizationTime.
58
-
Last optimization time specifies the data and time when an optimization job was run last on the specified volume.
59
-
This date and time stays constant between optimization jobs.
60
-
- LastGarbageCollectionTime.
61
-
Last garbage collection time specifies the data and time when a garbage collection job was run last on the specified volume.
62
-
This date and time stays constant between optimization jobs.
63
-
- LastScrubbingTime.
64
-
Last scrubbing time specifies the data and time when a scrubbing job was run last on the specified volume.
65
-
This date and time stays constant between optimization jobs.
37
+
This cmdlet returns the following metadata:
38
+
39
+
-`DedupSavedSpace`
40
+
- Saved space is the difference between the logical size of the optimized files
41
+
and the logical size of the store. This is the deduplicated user data plus data deduplication
42
+
metadata. This number changes continually.
43
+
-`DedupRate`
44
+
- Data deduplication rate is the ratio of data deduplication saved space to the logical
45
+
size of all of the files on the volume and is expressed in percentage. This number will change
46
+
continually.
47
+
-`OptimizedFilesCount`
48
+
- Optimized files count is the number of optimized files on the specified volume. This number
49
+
remains steady, instead of decreasing, as users delete files from, or add files to, the volume,
50
+
until a garbage collection job is run. This count is most accurate after a garbage collection
51
+
job runs.
52
+
-`OptimizedFilesSize`
53
+
- Optimized files size is the aggregate size of all optimized files on the specified volume. This
54
+
number remains steady, instead of decreasing, as users delete files from, or add new files to,
55
+
the volume, until a garbage collection job is run. This number is most accurate after a garbage
56
+
collection job runs.
57
+
-`InPolicyFilesCount`
58
+
- In policy files count is the number of files that currently qualify for optimization. This
59
+
number stays relatively constant between optimization jobs.
60
+
-`InPolicyFilesSize`
61
+
- In policy files size is the aggregate size of all files that currently qualify for optimization.
62
+
This number stays relatively constant between optimization jobs.
63
+
-`LastOptimizationTime`
64
+
- Last optimization time specifies the data and time when an optimization job was run last on the
65
+
specified volume. This date and time stays constant between optimization jobs.
66
+
-`LastGarbageCollectionTime`
67
+
- Last garbage collection time specifies the data and time when a garbage collection job was run
68
+
last on the specified volume. This date and time stays constant between optimization jobs.
69
+
-`LastScrubbingTime`
70
+
- Last scrubbing time specifies the data and time when a scrubbing job was run last on the
71
+
specified volume. This date and time stays constant between optimization jobs.
66
72
67
73
## EXAMPLES
68
74
69
75
### Example 1: Scan a volume for savings information
70
-
```
71
-
PS C:\> Update-DedupStatus -Volume "D:"
76
+
77
+
```powershell
78
+
Update-DedupStatus -Volume "D:"
72
79
```
73
80
74
-
This command scans the D: volume to compute data deduplication savings.
81
+
This command scans the `D:` volume to compute data deduplication savings.
75
82
76
83
## PARAMETERS
77
84
78
85
### -AsJob
79
-
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.
80
86
81
-
The cmdlet immediately returns an object that represents the job and then displays the command prompt.
82
-
You can continue to work in the session while the job completes.
83
-
To manage the job, use the `*-Job` cmdlets.
84
-
To get the job results, use the [Receive-Job](https://go.microsoft.com/fwlink/?LinkID=113372) cmdlet.
87
+
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to
88
+
complete.
85
89
86
-
For more information about Windows PowerShell background jobs, see [about_Jobs](https://go.microsoft.com/fwlink/?LinkID=113251).
90
+
The cmdlet immediately returns an object that represents the job and then displays the command
91
+
prompt. You can continue to work in the session while the job completes. To manage the job, use the
Runs the cmdlet in a remote session or on a remote computer.
102
-
Enter a computer name or a session object, such as the output of a [New-CimSession](/powershell/module/cimcmdlets/new-cimsession) or [Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966) cmdlet.
103
-
The default is the current session on the local computer.
111
+
112
+
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session
113
+
object, such as the output of a [New-CimSession](/powershell/module/cimcmdlets/new-cimsession) or
114
+
[Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966) cmdlet. The default is the
Specifies the maximum number of concurrent operations that can be established to run the cmdlet.
119
-
If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer.
120
-
The throttle limit applies only to the current cmdlet, not to the session or to the computer.
130
+
131
+
Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If
132
+
this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an
133
+
optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the
134
+
computer. The throttle limit applies only to the current cmdlet, not to the session or to the
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
169
+
170
+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
0 commit comments