Set-DPMGlobalProperty

Module:

DataProtectionManager Module

Sets the global properties for a DPM installation.

Syntax

IsNetworkChecksumRequired

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -IsNetworkChecksumRequired <Boolean>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

TruncateSharePointDbLogs

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -TruncateSharePointDbLogs <Boolean>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LibraryRefreshInterval

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -LibraryRefreshInterval <Int32>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AllowLocalDataProtection

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -AllowLocalDataProtection <Boolean>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ExchangeSCRProtection

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -ExchangeSCRProtection <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RegisteredWriters

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -RegisteredWriters <Guid[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ConsiderForAutoDeployment

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -ConsiderForAutoDeployment <Boolean>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

MaxCapacityForClientAutoDeployment

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -MaxCapacityForClientAutoDeployment <Int32>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

KnownVMMServers

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -KnownVMMServers <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

HyperVPagefileExclusions

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -HyperVPagefileExclusions <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DPMStorageVolumeExclusion

Set-DPMGlobalProperty
    [[-DPMServerName] <String>]
    -DPMStorageVolumeExclusion <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Set-DPMGlobalProperty cmdlet sets the global properties for a System Center - Data Protection Manager (DPM) installation.

Examples

Example 1: Exclude page file VHDs

PS C:\>Set-DPMGlobalProperty -DPMServerName "Contoso-DPMServer" -HyperVPagefileExclusions "*_pagefile.vhd"

This command excludes all protected VHDs with names that include the string _pagefile.vhd on the server named Contoso-DPMServer.

Example 2: Exclude VHDs using wildcard expressions exclusions

PS C:\>Set-DPMGlobalProperty -DPMServerName "Contoso-DPMServer" -HyperVPagefileExclusions "*_pagefile.vhd,*mypgf*.vhd*"

This command excludes VHD files that include the strings mypgf and pagefile.vhd in their names.

Example 3: Remove all VHD exclusions

PS C:\>Set-DPMGlobalProperty -DPMServerName "Contoso-DPMServer" -HyperVPagefileExclusions ""

This command removes all existing exclusions by specifying an empty list for the HyperVPagefileExclusions parameter.

Example 4: Exclude a volume from being available for DPM

PS C:\>Set-DPMGlobalProperty -DPMServerName "Contoso-DPMServer" -DPMStorageVolumeExclusion "F:,C:\MountPoint1"

This command excludes F:\ and C:\MountPoint1 from being available to DPM as a storage volume.

Parameters

-AllowLocalDataProtection

Indicates whether a DPM server can protect data sources on the same computer on which it is installed.

Parameter properties

Type:	Boolean
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

AllowLocalDataProtection

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:	SwitchParameter
Default value:	False
Supports wildcards:	False
DontShow:	False
Aliases:	cf

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ConsiderForAutoDeployment

Indicates whether to consider a DPM server for client protection.

Parameter properties

Type:	Boolean
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

ConsiderForAutoDeployment

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DPMServerName

Specifies the name of a DPM server on which this cmdlet acts.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	1
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DPMStorageVolumeExclusion

Specifies the names of volumes and mount points to exclude from being available to DPM as a storage target. To specify the names of multiple volumes or mount points, list them individually, separated by commas. Applicable SC 2016 DPM UR4 onwards.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

DPMStorageVolumeExclusions

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ExchangeSCRProtection

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.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

ExchangeSCRProtection

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-HyperVPagefileExclusions

Specifies the name of a virtual hard disk drive (VHD) pagefile to exclude from backup jobs for a firstref_virtualname data source. To specify the names of multiple VHD pagefiles, list them individually, separated by commas. This parameter also accepts wildcard values.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

HyperVPagefileExclusions

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-IsNetworkChecksumRequired

Indicates whether to apply a checksum to verify data transferred over a network.

Parameter properties

Type:	Boolean
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

IsNetworkChecksumRequired

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-KnownVMMServers

Specifies a vmm12sp1_long server that communicates with DPM to provide support for virtual machine mobility scenarios. If you specify this parameter, DPM stores the vmm12short server information and configures its services to communicate with the vmm12short.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

KnownVMMServers

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-LibraryRefreshInterval

Specifies the refresh interval for gathering information about shared libraries.

Parameter properties

Type:	Int32
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

LibraryRefreshInterval

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-MaxCapacityForClientAutoDeployment

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.

Parameter properties

Type:	Int32
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

MaxCapacityForClientAutoDeployment

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-RegisteredWriters

For internal use only.

Parameter properties

Type:	Guid[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

RegisteredWriters

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-TruncateSharePointDbLogs

Indicates whether to truncate SharePoint database logs during replication.

Parameter properties

Type:	Boolean
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

TruncateSharePointDbLogs

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-WhatIf

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

Parameter properties

Type:	SwitchParameter
Default value:	False
Supports wildcards:	False
DontShow:	False
Aliases:	wi

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Related Links

• Get-DPMGlobalProperty