Disable-DedupVolume
Disable-DedupVolume
Disables data deduplication activity on one or more volumes.
구문
Parameter Set: Disable1
Disable-DedupVolume [-Volume] <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-DataAccess] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
자세한 설명
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.
매개 변수
-AsJob
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-CimSession<CimSession[]>
원격 세션에서 또는 원격 컴퓨터에서 cmdlet을 실행합니다. New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 컴퓨터 이름이나 세션 개체를 입력합니다. 기본값은 로컬 컴퓨터의 현재 세션입니다.
별칭 |
Session |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-DataAccess
Indicates that data access to deduplicated files on the volume is disabled.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-ThrottleLimit<Int32>
이 cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수가 생략되거나 값 0
이 입력되면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 제한 한도를 계산합니다. 제한 한도는 현재 cmdlet에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-Volume<String[]>
Specifies an array of system volumes for which to disable data deduplication. Specify one or more volume IDs, drive letters (such as D:
), or volume GUID pathnames (using the form \\?\Volume{{GUID}}\
). Separate multiple volumes with a comma.
별칭 |
Path,Name,DeviceId |
필수 여부 |
true |
위치 |
1 |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
<CommonParameters>
이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).
입력
입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.
- System.String[]
출력
출력 유형은 cmdlet이 내보내는 개체의 유형입니다.
Microsoft.Management.Infrastructure.CimInstance#
Microsoft.Management.Infrastructure.CimInstance
개체는 WMI(Windows Management Instrumentation) 개체를 표시하는 래퍼 클래스입니다. 파운드 기호(#
) 뒤에 오는 경로는 기본 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 IO activity for a specified volume
This command suspends IO 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, IO 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