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