Set-WBPerformanceConfiguration
Set-WBPerformanceConfiguration
Sets the current volume backup performance settings.
Syntax
Parameter Set: OverallSetting
Set-WBPerformanceConfiguration [-OverallPerformanceSetting] [-PerformanceSetting] <WBPerformanceConfiguration> [ <CommonParameters>]
Parameter Set: Volume
Set-WBPerformanceConfiguration [-Volume] <WBVolume> [-PerformanceSetting] <WBPerformanceConfiguration> [ <CommonParameters>]
Detailed 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.
Parameters
-OverallPerformanceSetting
If present, specifies that the changes affect the global performance setting. If not present, then the Volume parameter must be specified.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PerformanceSetting<WBPerformanceConfiguration>
The valid settings 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.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Volume<WBVolume>
Specifies the object for the current performance settings.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
SwitchParameter, WBVolume
Indicates either a global setting or the per volume performance setting.
Outputs
The output type is the type of the objects that the cmdlet emits.
- None
Examples
Example 1: Set the global performance setting
This command sets the global performance settings as incremental for volume backups.
PS C:\> Set-WBPerformanceSetting -OverallPerformanceSetting AlwaysIncremental
Example 2: Set a specific volume performance setting
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.
PS C:\> $Backup = Get-WBBackupSet
PS C:\> Set-WBPerformanceSetting -Volume $Backup.Volume[1] AlwaysFull