Update-DedupStatus

Update-DedupStatus

Scans one or more specified volumes to compute fresh data deduplication savings information and returns a DeduplicationStatus object.

구문

Parameter Set: Update0
Update-DedupStatus [[-Volume] <String[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

자세한 설명

The Update-DedupStatus cmdlet scans one or more specified volumes to compute fresh data deduplication savings information. This cmdlet returns a DeduplicationStatus object. For quick access to cached metadata use Get-DedupStatus. When this cmdlet is run on multiple volumes with one cmdlet call, the analysis for each volume is done serially.

Note: On large volumes this cmdlet can run for several minutes and will always perform a rescan after the initial scan. The default behavior is to wait for completion, regardless of the length of time required to run the scan and rescan.

이 cmdlet을 실행하려면 관리자 권한으로 실행 옵션으로 Windows PowerShell®을 시작해야 합니다.

This cmdlet returns the following metadata:
- DedupSavedSpace: Saved space is the difference between the logical size of the optimized files and the logical size of the store (the deduplicated user data plus data deduplication metadata). This number will change continually.
- DedupRate: Data deduplication rate is the ratio of data deduplication saved space to the logical size of all of the files on the volume and is expressed in percentage. This number will change continually.
- OptimizedFilesCount: Optimized files count is the number of optimized files on the specified volume. Note that this number will remain steady (instead of decrease) as users delete files from, or add files to, the volume—until a garbage collection job is run. This count is most accurate after a garbage collection job runs.
- OptimizedFilesSize: Optimized files size is the aggregate size of all optimized files on the specified volume. Note that this number will remain steady (instead of decrease) as users delete files from, or add new files to, the volume—until a garbage collection job is run. This number is most accurate after a garbage collection job runs.
- InPolicyFilesCount: In policy files count is the number of files that currently qualify for optimization. This number will stay relatively constant between optimization jobs.
- InPolicyFilesSize: In policy files size is the aggregate size of all files that currently qualify for optimization. This number will stay relatively constant between optimization jobs.
- LastOptimizationTime: Last optimization time specifies the data and time when an optimization job was run last on the specified volume. This date and time will stay constant between optimization jobs.
- LastGarbageCollectionTime: Last garbage collection time specifies the data and time when a garbage collection job was run last on the specified volume. This date and time will stay constant between optimization jobs.
- LastScrubbingTime: Last scrubbing time specifies the data and time when a scrubbing job was run last on the specified volume. This date and time will stay constant between optimization jobs.

매개 변수

-AsJob

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-CimSession<CimSession[]>

원격 세션에서 또는 원격 컴퓨터에서 cmdlet을 실행합니다. New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 컴퓨터 이름이나 세션 개체를 입력합니다. 기본값은 로컬 컴퓨터의 현재 세션입니다.

별칭

Session

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ThrottleLimit<Int32>

이 cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수가 생략되거나 값 0이 입력되면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 제한 한도를 계산합니다. 제한 한도는 현재 cmdlet에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-Volume<String[]>

Specifies one or more file system volumes for which to scan and compute fresh data deduplication savings information. Enter 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

필수 여부

false

위치

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: Scan a volume for savings information

This command scans the D: volume to compute data deduplication savings.

PS C:\> Update-DedupStatus -Volume "D:"

관련 항목

Get-DedupStatus