Disable-DedupVolume

Disable-DedupVolume

Disables data deduplication activity on one or more volumes.

语法

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

详细说明

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.

参数

-CimSession<CimSession[]>

在远程会话中或远程计算机上运行该 cmdlet。输入计算机名或会话对象，如 New-cimsession 或 Get-cimsession cmdlet 的输出。默认为本地计算机上的当前会话。

-DataAccess

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

-InformationAction<System.Management.Automation.ActionPreference>

-InformationVariable<System.String>

-ThrottleLimit<Int32>

指定为运行该 cmdlet 而可以建立的最大并发操作数。如果省略此参数或输入值为 0，Windows PowerShell® 则根据计算机上运行的 CIM cmdlet 数来计算最佳节流限制。节流限制仅应用于当前 cmdlet，不应用于会话或计算机。

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

<CommonParameters>

此 cmdlet 支持常见的参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 TechNet 上的 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

<WorkflowParameters>

输入

输入类型是可以传送到 cmdlet 的对象的类型。

• System.String[]

输出

输出类型是 cmdlet 发出的对象的类型。

• Microsoft.Management.Infrastructure.CimInstance#

  Microsoft.Management.Infrastructure.CimInstance 对象是显示 Windows Management Instrumentation (WMI) 对象的包装类。井号 (#) 后面的路径提供基础 WMI 对象的命名空间和类名。

示例

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

相关主题

Enable-DedupVolume

Get-DedupVolume

Set-DedupVolume

Update-DedupStatus