Get-DedupVolume

Get-DedupVolume

Returns deduplication volumes that have data deduplication metadata.

Syntaxe

Parameter Set: ByVolumeId
Get-DedupVolume [-CimSession <CimSession[]> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-ThrottleLimit <Int32> ] [-VolumeId <String[]> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: ByVolume
Get-DedupVolume [[-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-DedupVolume cmdlet returns a DeduplicationVolume object for each volume that has data deduplication metadata, in either the enabled or disabled state. In a cluster, this cmdlet returns a DeduplicationVolume object only for volumes currently mounted by the managed node, whether the volumes are local or clustered volumes.

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

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 data deduplication metadata, or in the case of a cluster, volumes with data deduplication metadata currently mounted by the managed node. 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.

Alias	none
Requis ?	false
Position ?	1
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-VolumeId<String[]>

Specifies a string that uniquely identifies the volume on which to return data deduplication metadata.

Alias	ObjectId,Id,DeviceId
Requis ?	false
Position ?	named
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_DedupVolume

  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 settings for a volume identified by letter

This command returns the data deduplication settings for volume E:.

PS C:\> Get-DedupVolume –Volume "E:"

Example 2: Get settings for a volume specified by ID

This command returns the data deduplication settings for the volume that has the specified GUID.

PS C:\> Get-DedupVolume –Volume "\\?\Volume{26a21bda-a627-11d7-9931-806e6f6e6963}\"

Rubriques connexes

Disable-DedupVolume

Enable-DedupVolume

Set-DedupVolume