Share via


Set-DPMPerformanceOptimization

Set-DPMPerformanceOptimization

Enables or disables on-the-wire compression for a DPM protection group.

Syntax

Parameter Set: DisableCompression
Set-DPMPerformanceOptimization [-ProtectionGroup] <ProtectionGroup> -DisableCompression [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: EnableCompression
Set-DPMPerformanceOptimization [-ProtectionGroup] <ProtectionGroup> -EnableCompression [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-DPMPerformanceOptimization cmdlet enables or disables on-the-wire compression of data for a System Center 2012 – Data Protection Manager (DPM) protection group. First, get a protection group by using the Get-DPMProtectionGroup cmdlet. Then, use the Get-DPMModifiableProtectionGroup cmdlet to let you change that protection group.

On-the-wire compression decreases the amount of data transferred during replica creation, synchronization, and consistency check operations. On-the-wire compression increases CPU usage on both the DPM server and on protected computers.

Parameters

-DisableCompression

Indicates that the cmdlet disables on-the-wire compression of data.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EnableCompression

Indicates that the cmdlet enables on-the-wire compression of data.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProtectionGroup<ProtectionGroup>

Specifies a protection group that this cmdlet modifies. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

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.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • ProtectionGroup

Examples

Example 1: Enable compression for a protection group

The first command uses the Get-DPMProtectionGroup cmdlet to get the protection group for the DPM server named DPMServer07, and stores that object in the $PGroup variable.

The second command uses the Get-DPMModifiableProtectionGroup cmdlet to get the protection group in $PGroup in an editable format, and then stores that object in the $MPGroup variable.

The third command enables compression for the protection group in $MPGroup.

PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer07"
PS C:\> $MPGroup = Get-DPMModifiableProtectionGroup -ProtectionGroup $PGroup
PS C:\> Set-DPMPerformanceOptimization -ProtectionGroup $MPGroup -EnableCompression

Get-DPMProtectionGroup

Get-DPMModifiableProtectionGroup