Windows Dev Center

MSFT_DedupJobSchedule class

Represents a data deduplication schedule.

The following syntax is simplified from MOF code and includes all inherited properties.

Syntax

class MSFT_DedupJobSchedule
{
  string   Name;
  string   ScheduledTask;
  uint32   Type;
  boolean  StopWhenSystemBusy;
  uint32   Priority;
  uint32   Memory;
  uint32   Cores;
  uint32   InputOutputThrottle;
  uint32   InputOutputThrottleLevel;
  boolean  Enabled;
  datetime Start;
  uint32   DurationHours;
  sint32   Days[];
  boolean  Full;
  boolean  ReadOnly;
};

Members

The MSFT_DedupJobSchedule class has these types of members:

Methods

The MSFT_DedupJobSchedule class has these methods.

MethodDescription
Create

Creates a new data deduplication schedule, with default settings, if none are specified, and returns a deduplication schedule CIM object that can be used to customize the schedule.

 

Properties

The MSFT_DedupJobSchedule class has these properties.

Cores
Data type: uint32
Access type: Read/write

Windows Server 2012 R2 and Windows Server 2012:  This property is not available before Windows Server Technical Preview.

The maximum percentage of physical machine cores that the job can use.

Days
Data type: sint32 array
Access type: Read/write
Qualifiers: Values ( "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" ) , ValueMap ("0", "1", "2", "3", "4", "5", "6")

The day of the week on which this weekly schedule runs.

DurationHours
Data type: uint32
Access type: Read/write

The number of hours that this job should run before it is stopped if the job is not completed prior to the elapsed hours. All deduplication jobs can be safely stopped with no impact on the files in process. If this property is set to zero, the scheduled job runs until completed.

Enabled
Data type: boolean
Access type: Read/write

If true, this job runs when the system clock reaches the date and time specified by the Start property. If false, the schedule remains in a disabled state and does not run at the time specified by the Start property.

Full
Data type: boolean
Access type: Read-only

If true, the job runs in a more thorough and resource intensive mode. This property only applies to garbage collection and scrubbing jobs.

InputOutputThrottle
Data type: uint32
Access type: Read/write

Windows Server 2012 R2 and Windows Server 2012:  This property is not available before Windows Server Technical Preview.

The amount of I/O throttling of the job to ensure that it does not interfere with other heavy I/O processes on the system. This value can range from "0" to "100".

InputOutputThrottleLevel
Data type: uint32
Access type: Read/write

Amount that the deduplication job throttles I/O to limit interference with other I/O intense processes.

Windows Server 2012:   This property is not supported until Windows Server 2012 R2.

None (1)
Low (2)
Medium (3)
High (4)
Maximum (5)
Memory
Data type: uint32
Access type: Read/write

The maximum percentage of physical machine memory that can be consumed by this job. For optimization jobs, a range from 15-50 is suggested—with lower memory consumption for jobs that are scheduled to run when the StopWhenSystemBusy property is set to false. For garbage collection and scrubbing jobs, which are typically run at off hours, a higher memory consumption can be safely specified—for example, 50.

Name
Data type: string
Access type: Read-only
Qualifiers: Key

The friendly name for the data deduplication job schedule.

Priority
Data type: uint32
Access type: Read/write
Qualifiers: Values ( "Low", "Normal", "High" ) , ValueMap ("1", "2", "3")

Sets the CPU and I/O priority for the optimization job run by this schedule. For jobs that are scheduled to run when the StopWhenSystemBusy property is set to false, setting this property to Low might make sense. For most other optimization jobs, setting this property to Normal is the most efficient.

ReadOnly
Data type: boolean
Access type: Read-only

If True, the job runs in read-only mode.

ScheduledTask
Data type: string
Access type: Read-only

This property is reserved for system use.

Start
Data type: datetime
Access type: Read/write

The time to start this job. By default, this property is set to 1:45 A. M. Type the date in a format that is standard for the system locale, such as dd-MM-yyyy (German [Germany]) or MM/dd/yyyy (English [United States]).

StopWhenSystemBusy
Data type: boolean
Access type: Read/write

If true, the job stops running when the system is busy and retries later. If the schedule is for high priority jobs, then set this property to false.

Type
Data type: uint32
Access type: Read-only

The type of data deduplication job to run when this schedule is triggered.

ValueMeaning
Optimization
1

This job performs both deduplication and compression of files according data deduplication policy for the volume. After initial optimization of a file, if that file is then modified and again meets the data deduplication policy threshold for optimization, the file is optimized again.

GarbageCollection
2

This job processes previously deleted or logically overwritten optimized content to create usable volume free space. When an optimized file is deleted or overwritten by new data, the old data in the chunk store is not deleted right away. By default, garbage collection is scheduled to run weekly. We recommend to run garbage collection only after large deletions have occurred.

Scrubbing
3

This job processes data corruptions found during data integrity validation, performs possible corruption repair, and generates a scrubbing report.

Unoptimization
4

This job undoes deduplication on all of the optimized files on the volume. At the end of a successful unoptimization job, all of the data deduplication metadata is deleted from the volume.

 

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2012

Namespace

Root\Microsoft\Windows\Deduplication

MOF

DeduplicationProvider.mof

 

 

Show:
© 2015 Microsoft