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