Set-WBPerformanceConfiguration
Sets the current volume backup performance settings.
Syntax
Volume
Set-WBPerformanceConfiguration
[-Volume] <WBVolume>
[-PerformanceSetting] <WBPerformanceConfiguration>
[<CommonParameters>]
OverallSetting
Set-WBPerformanceConfiguration
[-PerformanceSetting] <WBPerformanceConfiguration>
[-OverallPerformanceSetting]
[<CommonParameters>]
Description
The Set-WBPerformanceSetting cmdlet sets the current volume backup performance settings. The settings are applicable only for volume backups; these settings are not applicable for files, folders, system state, or applications. The settings apply globally to all volumes in a backup, or to specific volumes.
Examples
Example 1: Set the global performance setting
PS C:\> Set-WBPerformanceConfiguration -OverallPerformanceSetting AlwaysIncremental
This command sets the global performance settings as incremental for volume backups.
Example 2: Set a specific volume performance setting
PS C:\> $Backup = Get-WBBackupSet
PS C:\> Set-WBPerformanceConfiguration -Volume $Backup.Volume[1] AlwaysFull
This example sets the performance settings for a specific volume.
The first command stores the result of the Get-WBBackupSet cmdlet in the variable named $Backup.
The second command sets the AlwaysFull performance setting on the second volume of $Backup.
Parameters
-OverallPerformanceSetting
Indicates that the changes affect the global performance setting. If you do not use this parameter, then the Volume parameter must be specified.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
OverallSetting
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PerformanceSetting
Specifies the performance settings for which this cmdlet sets. The acceptable values for this parameter are::
- AlwaysFull: The time to create a backup is proportional to the size of volume being backed up. This can be set at a global level for all volumes or specific for some volumes.
- AlwaysIncremental: Increase the backup speed by just tracking the changes between the last and current backup. This option is not recommended for servers with disk-intensive operation which may experience reduced disk throughput on volumes included in the backup. This can be set at a global level for all volumes or specific for some volumes.
Parameter properties
| Type: | WBPerformanceConfiguration |
| Default value: | None |
| Accepted values: | AlwaysFull, AlwaysIncremental, Custom |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Volume
Specifies the object for which this cmdlet sets the current performance settings.
Parameter properties
| Type: | WBVolume |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Volume
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.