Set-DPMGlobalProperty
Set-DPMGlobalProperty
Sets the global properties for a DPM installation.
Syntax
Parameter Set: AllowLocalDataProtection
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -AllowLocalDataProtection <Boolean> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ConsiderForAutoDeployment
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -ConsiderForAutoDeployment <Boolean> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ExchangeSCRProtection
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -ExchangeSCRProtection <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: HyperVPagefileExclusions
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -HyperVPagefileExclusions <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: IsNetworkChecksumRequired
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -IsNetworkChecksumRequired <Boolean> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: KnownVMMServers
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -KnownVMMServers <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: LibraryRefreshInterval
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -LibraryRefreshInterval <Int32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: MaxCapacityForClientAutoDeployment
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -MaxCapacityForClientAutoDeployment <Int32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: RegisteredWriters
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -RegisteredWriters <Guid[]> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: TruncateSharePointDbLogs
Set-DPMGlobalProperty [[-DPMServerName] <String> ] -TruncateSharePointDbLogs <Boolean> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-DPMGlobalProperty cmdlet sets the global properties for a System Center 2012 – Data Protection Manager (DPM) installation.
Parameters
-AllowLocalDataProtection<Boolean>
Indicates whether a DPM server can protect data sources on the same computer on which it is installed.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ConsiderForAutoDeployment<Boolean>
Indicates whether to consider a DPM server for client protection.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-DPMServerName<String>
Specifies the name of a DPM server on which this cmdlet acts.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ExchangeSCRProtection<String>
Specifies the name of a Microsoft Exchange Server Standby Continuous Replication (SCR) Server. To specify the names of multiple servers, list them individually, separated by commas.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-HyperVPagefileExclusions<String>
Specifies the name of a VHD pagefile to exclude from backup jobs for a data source. To specify the names of multiple VHD pagefiles, list them individually, separated by commas. This parameter also accepts wildcard values.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-IsNetworkChecksumRequired<Boolean>
Indicates whether to apply a checksum to verify data transferred over a network.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-KnownVMMServers<String>
Specifies a Virtual Machine Manager (VMM) server that communicates with DPM to provide support for virtual machine mobility scenarios. If you specify this parameter, DPM stores the VMM server information and configures its services to communicate with the VMM.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-LibraryRefreshInterval<Int32>
Specifies the refresh interval for gathering information about shared libraries.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-MaxCapacityForClientAutoDeployment<Int32>
Specifies the maximum number of client computers that a DPM server can protect. Set this value to guarantee that DPM protects a reasonable number of client computers if auto-deployment is enabled by specifying the ConsiderForAutoDeployment parameter.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RegisteredWriters<Guid[]>
For internal use only.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-TruncateSharePointDbLogs<Boolean>
Indicates whether to truncate SharePoint database logs during replication.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
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.
Examples
Example 1: Exclude page file VHDs
This command excludes all protected VHDs with names that include the string _pagefile.vhd on the server named Contoso-DPMServer.
PS C:\> Set-DPMGlobalProperty -DPMServerName "Contoso-DPMServer" -HyperVPagefileExclusions "*_pagefile.vhd"
Example 2: Exclude VHDs using wildcard expressions exclusions
This command excludes VHD files that include the strings mypgf and pagefile.vhd in their names.
PS C:\> Set-DPMGlobalProperty -DPMServerName "Contoso-DPMServer" -HyperVPagefileExclusions "*_pagefile.vhd,*mypgf*.vhd*"
Example 3: Remove all VHD exclusions
This command removes all existing exclusions by specifying an empty list for the HyperVPagefileExclusions parameter.
PS C:\> Set-DPMGlobalProperty -DPMServerName "Contoso-DPMServer" -HyperVPagefileExclusions ""