Enable-DedupVolume
Enable-DedupVolume
Enables data deduplication on one or more volumes.
Syntaxe
Parameter Set: Enable0
Enable-DedupVolume [-Volume] <String[]> [-CimSession <CimSession[]> ] [-DataAccess] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-ThrottleLimit <Int32> ] [-UsageType <UsageType> {Default | HyperV | Backup} ] [ <CommonParameters>] [ <WorkflowParameters>]
Description détaillée
The Enable-DedupVolume cmdlet enables data deduplication on one or more volumes. You can use the Set-DedupVolume cmdlet to customize the data deduplication settings. Data deduplication is disabled by default. Data deduplication is not supported for certain volumes, such as any volume that is not a NTFS file system or any volume that is smaller than 2 GB.
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 enabled.
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 |
-UsageType<UsageType>
Specifies the expected type of workload for the volume. This cmdlet sets several low-level settings to default values that are appropriate to the usage type that you specify. If you specify this parameter for a volume that already has data deduplication enabled, the cmdlet modifies the settings to the appropriate default values. If you run this cmdlet on a volume that already has data deduplication enabled but do not specify this parameter, the cmdlet does not change the usage type. Les valeurs acceptables pour ce paramètre sont les suivantes :
-- HyperV. A volume for Hyper-V storage.
-- Backup. A volume that is optimized for virtualized backup servers.
-- Default. A general purpose volume. If you do not specify a value for this parameter, the cmdlet uses a value of Default.
If you specify a value of HyperV, the computer that has data deduplication enabled cannot be the same computer that runs Hyper-V. The two computers must communicate remotely.
Alias |
none |
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 |
-Volume<String[]>
Specifies an array of system volumes. 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: Enable data deduplication on volumes
This command enables data deduplication on volumes D:, E:, and F:. This command does not specify a value for the UsageType parameter, and, therefore, the cmdlet uses defaults for general purpose file server operations.
PS C:\> Enable-DedupVolume -Volume "D:","E:","F:"
Example 2: Enable data deduplication on a volume for Hyper-V storage
This command enables data duplication on the D: volume. The command specifies Hyper-V storage as the usage type for this volume.
PS C:\> Enable-DedupVolume -Volume "D:" -UsageType HyperV
Example 3: Enable data deduplication on a volume by using a GUID
This command enables data deduplication for the volume that has the GUID 26a21bda-a627-11d7-9931-806e6f6e6963.
PS C:\> Enable-DedupVolume -Volume "\\?\Volume{26a21bda-a627-11d7-9931-806e6f6e6963}\"
Example 4: Resume I/O activity on a specified volume/
This command resumes I/O activity for data deduplication on the specified volume. Effectively, this command causes the data deduplication file system mini-filter to attach to the specified volume
PS C:\> Enable-DedupVolume -Volume "X:" -DataAccess