Update-DedupStatus

Update-DedupStatus

Scans volumes for fresh data deduplication savings.

Syntaxe

Parameter Set: Update0
Update-DedupStatus [[-Volume] <String[]> ] [-CimSession <CimSession[]> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

Description détaillée

The Update-DedupStatus cmdlet scans one or more specified volumes to compute fresh data deduplication savings information. This cmdlet returns a DeduplicationStatus object. For quick access to cached metadata use Get-DedupStatus. When this cmdlet is run on multiple volumes with one cmdlet call, the analysis for each volume is done serially.

Note: On large volumes this cmdlet can run for several minutes and will always perform a rescan after the initial scan. The default behavior is to wait for completion, regardless of the length of time required to run the scan and rescan.

Pour exécuter cette applet de commande, vous devez lancer Windows PowerShell® avec l'option Exécuter en tant qu’administrateur.

This cmdlet returns the following metadata:

-- DedupSavedSpace. Saved space is the difference between the logical size of the optimized files and the logical size of the store. This is the deduplicated user data plus data deduplication metadata. This number changes continually.
-- DedupRate. 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. This number will change continually.
-- OptimizedFilesCount. Optimized files count is the number of optimized files on the specified volume. 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. This count is most accurate after a garbage collection job runs.
-- OptimizedFilesSize. Optimized files size is the aggregate size of all optimized files on the specified volume. 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. This number is most accurate after a garbage collection job runs.
-- InPolicyFilesCount. In policy files count is the number of files that currently qualify for optimization. This number stays relatively constant between optimization jobs.
-- InPolicyFilesSize. In policy files size is the aggregate size of all files that currently qualify for optimization. This number stays relatively constant between optimization jobs.
-- LastOptimizationTime. Last optimization time specifies the data and time when an optimization job was run last on the specified volume. This date and time stays constant between optimization jobs.
-- LastGarbageCollectionTime. Last garbage collection time specifies the data and time when a garbage collection job was run last on the specified volume. This date and time stays constant between optimization jobs.
-- LastScrubbingTime. Last scrubbing time specifies the data and time when a scrubbing job was run last on the specified volume. This date and time stays constant between optimization jobs.

Paramètres

-CimSession<CimSession[]>

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tels que le résultat d'une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

-InformationAction<System.Management.Automation.ActionPreference>

-InformationVariable<System.String>

-ThrottleLimit<Int32>

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si la valeur 0 est entrée, Windows PowerShell® calcule un seuil de limitation optimal pour l'applet de commande en fonction du nombre d'applets de commande CIM exécutées sur l'ordinateur. Le seuil de limitation s'applique uniquement à l'applet de commande en cours, non pas à la session ou à l'ordinateur.

-Volume<String[]>

Specifies one or more file system volumes for which to scan and compute fresh data deduplication savings information. Enter one or more volume IDs, drive letters, or volume GUID paths. For drive letters, use the format D:. For volume GUID paths, use the format \\?\Volume{{GUID}}\. Separate multiple volumes with a comma.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

<WorkflowParameters>

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

• System.String[]

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

• Microsoft.Management.Infrastructure.CimInstance#

  L'objet Microsoft.Management.Infrastructure.CimInstance est une classe de wrapper qui affiche les objets WMI (Windows Management Instrumentation). Le chemin après le symbole # fournit l'espace de noms et le nom de classe de l'objet WMI sous-jacent.

Exemples

Example 1: Scan a volume for savings information

This command scans the D: volume to compute data deduplication savings.

PS C:\> Update-DedupStatus -Volume "D:"

Rubriques connexes

Get-DedupStatus