MSFT_DedupJobSchedule class
Represents a data deduplication schedule.
The following syntax is simplified from MOF code and includes all inherited properties.
Syntax
[dynamic, provider("DeduplicationProvider"), ClassVersion("1.0"), AMENDMENT]
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.
| Method | Description |
|---|---|
| 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
The maximum percentage of physical machine cores that the job can use.
Windows Server 2012 R2 and Windows Server 2012: This property is not available before Windows Server 2016.
-
-
Days
-
-
Data type: sint32 array
-
Access type: Read/write
The day of the week on which this weekly schedule runs.
-
-
Sunday (0)
-
Monday (1)
-
Tuesday (2)
-
Wednesday (3)
-
Thursday (4)
-
Friday (5)
-
Saturday (6)
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/write
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
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".
Windows Server 2012 R2 and Windows Server 2012: This property is not available before Windows Server 2016.
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
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.
Low (1)
Normal (2)
High (3)
ReadOnly
-
Data type: boolean
-
Access type: Read/write
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.
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 |
|
| DLL |
|