Get-WBPerformance Configuration

Module:
windowsserverbackup
Gets the current volume backup performance settings.

Syntax 

Get-WBPerformanceConfiguration
   [-Volume] <WBVolume>
   [<CommonParameters>]
Get-WBPerformanceConfiguration
   [-OverallPerformanceSetting]
   [<CommonParameters>]

Description

The Get-WBPerformanceConfiguration cmdlet gets the current performance settings for volume backups. 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. 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 setting applies at a global level for all volumes or for specific 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.

  • Custom: This is the global setting reported in case there is a specific volume level setting set.

Examples

Example 1: Get global settings 

PS C:\> Get-WBPerformanceConfiguration -OverallPerformanceSetting AlwaysIncremental

This command gets the global settings for all volumes with the AlwaysIncremental setting.

Example 2: Get settings for a volume 

PS C:\> $Backup = Get-WBBackupSet
PS C:\> Get-WBPerformanceConfiguration -Volume $Backup.Volume[1] AlwaysFull

This example gets the settings for a specific volume with the AlwaysFull setting.

The first command gets the backup set from the local machine and stores the result in the variable named $Backup.

The second command gets the settings from the volume at index 1 that is stored in the $Backup variable.

Required Parameters

-OverallPerformanceSetting

Indicates that the returned data is used for the global setting.

Type: SwitchParameter
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Volume

Specifies the WBVolume object for which this cmdlet gets the current performance settings.

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

Inputs

SwitchParameter, WBVolume

Indicates either global settings or volume settings.