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 ""

Related topics

Get-DPMGlobalProperty