Get-DedupMetadata

Get-DedupMetadata

Returns metadata for volumes that have data deduplication metadata.

Syntaxe

Parameter Set: Query (cdxml)
Get-DedupMetadata [[-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 Get-DedupMetadata cmdlet returns a DeduplicationMetadata object for every volume that has optimization metadata. A DeduplicationMetadata object includes read-only properties describing the nature of the deduplication data store, such as chunk counts, container counts, average chunk size, and other statistics.

Because this cmdlet must scan the entire file system. this cmdlet requires some time to run.

This cmdlet cannot be part of a schedule; it must be run manually. If another optimization job is running on the specified volume when you start this cmdlet, then this cmdlet fails. It also fails if there is not enough memory for the file system scan and cmdlet processing. If the cmdlet fails, then review the events and log files for more information.

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 properties:

-- DataChunkCount. Indicates the number of data chunks in a container.
-- DataContainerCount. Indicates the number of containers in the data store.
-- DataChunkAverageSize. Indicates the data store size, not including chunk metadata, divided by the total number of data chunks in the data store.
-- StreamMapCount. Indicates the number of data streams in a container.
-- StreamMapContainerCount. Indicates the number of containers in the stream map store.
-- StreamMapAverageChunkCount. Indicates the stream map store size divided by the total number of streams in the store.
-- HotspotCount. Indicates the number of hotspots in a container.
-- HotspotContainerCount. Indicates the number of hotspots in the stream map store.
-- CorruptionCount. Indicates the number of corruptions found on the volume.

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.

Alias

Session

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InformationAction<System.Management.Automation.ActionPreference>

Alias

infa

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InformationVariable<System.String>

Alias

iv

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-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.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Volume<String[]>

Specifies one or more file system volumes for which to return a DeduplicationVolumeMetadata object.

Alias

Path,Name,DeviceId

Requis ?

false

Position ?

1

Valeur par défaut

none

Accepter l'entrée de pipeline ?

True (ByPropertyName)

Accepter les caractères génériques ?

false

<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.

  • Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Deduplication/MSFT_DedupVolumeMetadata

    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: Get metadata for a volume

This command gets metadata for the D: volume.

PS C:\> Get-DedupMetadata -Volume "D:"

Rubriques connexes

Measure-DedupFileMetadata