Set-WBPerformance Configuration

Module:
windowsserverbackup
Sets the current volume backup performance settings.

Syntax 

Set-WBPerformanceConfiguration
   [-Volume] <WBVolume>
   [-PerformanceSetting] <WBPerformanceConfiguration>
   [<CommonParameters>]
Set-WBPerformanceConfiguration
   [-OverallPerformanceSetting]
   [-PerformanceSetting] <WBPerformanceConfiguration>
   [<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.

Required 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.

Type: SwitchParameter
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.
Type: WBPerformanceConfiguration
Parameter Sets: AlwaysFull, AlwaysIncremental, Custom
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Volume

Specifies the object for which this cmdlet sets the current performance settings.

Type: WBVolume
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Inputs

SwitchParameter, WBVolume

You can pipe global settings or the per volume performance setting.

Outputs

None