Disable-DedupVolume

Disable-DedupVolume

Disables data deduplication activity on one or more volumes.

Syntaxe

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

Description détaillée

The Disable-DedupVolume cmdlet disables further data deduplication activity on one or more volumes. After you disable data deduplication, the volume remains in a deduplicated state and the existing deduplicated data is accessible. The server stops running data deduplication jobs for the volume and new data is not deduplicated. To undo data deduplication on a volume, use the Start-DedupJob cmdlet and specify Unoptimization for the Type parameter.

After you disable data deduplication on a volume, you can perform all read-only deduplication cmdlet operations on the volume. For example, you can use the Get-DedupStatus cmdlet to get deduplication status for a volume that has data deduplication metadata. After you disable data deduplication on a volume, you cannot use the data deduplication job-related cmdlets and the Update-DedupStatus cmdlet to perform operations on the volume. For example, you cannot use Start-DedupJob to start a data deduplication job for a volume on which you have disabled data deduplication.

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

-DataAccess

Indicates that data access to deduplicated files on the volume is disabled.

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

-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 an array of system volumes for which to disable data deduplication. Specify 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

Path,Name,DeviceId

Requis ?

true

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.

Exemples

Example 1: Disable data deduplication on volumes

This command disables data deduplication for volumes D:, E:, F:, and G:.

PS C:\> Disable-DedupVolume -Volume "D:","E:","F:","G:"

Example 2: Disable data deduplication on a volume by using a GUID

This command disables data deduplication for the volume that has the GUID 26a21bda-a627-11d7-9931-806e6f6e6963.

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

Example 3: Suspend I/O activity for a specified volume/

This command suspends I/O activity for data deduplication on the specified volume. Effectively, this command causes the data deduplication file system mini-filter to detach from the specified volume. After this command completes, I/O to data deduplication files fails with an ERROR_INVALID_FUNCTION error until either the Enable-DedupVolume -DataAccess command runs, or the restarts.

PS C:\> Disable-DedupVolume -Volume "X:" -DataAccess

Rubriques connexes

Enable-DedupVolume

Get-DedupVolume

Set-DedupVolume

Update-DedupStatus