Share via

Set-DPMDatasourceProtectionOption

Module:
DataProtectionManager Module

Sets protection options for a DPM data source.

Syntax

ExchangeOptions 

Set-DPMDatasourceProtectionOption
    [[-TopologyType] <ProtectionTopologyType>]
    [[-PreferredPhysicalNode] <String[][]>]
    [-ProtectionGroup] <ProtectionGroup>
    [-EseutilCheckType <EseutilTypeType>]
    [-BackUpType <AllowedBackupTypeType>]
    [-Datasource <Datasource>]
    [-ExchangeOptions]
    [-RunEseUtilConsistencyCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FileExclusionRemoveOptions 

Set-DPMDatasourceProtectionOption
    [-ProtectionGroup] <ProtectionGroup>
    [-FileType] <String>
    [-Remove]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FileExclusionAddOptions 

Set-DPMDatasourceProtectionOption
    [-ProtectionGroup] <ProtectionGroup>
    [-FileType] <String>
    [-Add]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ClientFileSpecOptions 

Set-DPMDatasourceProtectionOption
    [-ProtectionGroup] <ProtectionGroup>
    [-Path] <String>
    [-ClientFileSpecOperation] <ClientFileSpecOperationType>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AllowClientUserToAddFileSpecs 

Set-DPMDatasourceProtectionOption
    [-ProtectionGroup] <ProtectionGroup>
    [-AllowClientUserToAddFileSpecs] <Boolean>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AutoConsistencyCheck 

Set-DPMDatasourceProtectionOption
    [-ProtectionGroup] <ProtectionGroup>
    [-AutoConsistencyCheck] <Boolean>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Set-DPMDatasourceProtectionOption cmdlet sets protection options for a System Center - Data Protection Manager (DPM) data source. You can set the following protection options:

  • Exclude all files of a particular type from protection.
  • Remove exclusions.
  • Set protection options for a Microsoft Exchange Server data source.

Examples

Example 1: Set a consistency check for a protection group

PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> Set-DPMDatasourceProtectionOption -ProtectionGroup $PGroup -AutoConsistencyCheck $True

The first command gets the protection groups from the server named DPMServer02, and then stores the result in the $PGroup variable.

The second command sets an automatic consistency check to run on all protection groups in $PGroup.

Parameters

-Add

Indicates that the cmdlet adds a file exclusion to a protection group.

Parameter properties

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

Parameter sets

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

-AllowClientUserToAddFileSpecs

Indicates whether the user can specify which folders to protect.

Parameter properties

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

Parameter sets

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

-AutoConsistencyCheck

Indicates whether DPM automatically runs consistency checks on the data sources of a protection group if a replica becomes inconsistent.

Parameter properties

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

Parameter sets

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

-BackUpType

Indicates the type of backup.

The acceptable values for this parameter are:

  • CopyBackup
  • FullBackup

Parameter properties

Type:AllowedBackupTypeType
Default value:None
Accepted values:FullBackup, CopyBackup
Supports wildcards:False
DontShow:False

Parameter sets

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

-ClientFileSpecOperation

Indicates which folders to add to the inclusion list or remove from the exclusion list.

The acceptable values for this parameter are:

  • AddInclude
  • RemoveInclude
  • AddExclude
  • RemoveExclude

Parameter properties

Type:ClientFileSpecOperationType
Default value:None
Accepted values:AddInclude, RemoveInclude, AddExclude, RemoveExclude
Supports wildcards:False
DontShow:False

Parameter sets

ClientFileSpecOptions
Position:3
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

-Datasource

Specifies a data source object. A data source can be a file system share or volume, SQL Server database, Exchange Server storage group, Microsoft SharePoint farm, virtual machine, DPM database, or system state that is a member of a protection group.

Parameter properties

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

Parameter sets

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

-EseutilCheckType

Indicates how to run the Exchange Server database repair tool Eseutil.

The acceptable values for this parameter are:

  • DontRun
  • RunOnLogs
  • RunOnLogsAndDB

Parameter properties

Type:EseutilTypeType
Default value:None
Accepted values:DontRun, RunOnLogs, RunOnLogsAndDB
Supports wildcards:False
DontShow:False

Parameter sets

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

-ExchangeOptions

Indicates that this cmdlet operates on Exchange Server data sources.

Parameter properties

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

Parameter sets

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

-FileType

Specifies a file type to include in or exclude from a protection group.

Parameter properties

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

Parameter sets

FileExclusionRemoveOptions
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
FileExclusionAddOptions
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PassThru

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

Parameter properties

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

Parameter sets

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

-Path

Specifies the path of a folder to add to the inclusion list or remove from the exclusion list.

Parameter properties

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

Parameter sets

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

-PreferredPhysicalNode

Specifies an array of names of servers to protect for Preferred Server topology. This parameter applies only to servers that use cluster continuous replication in Microsoft Exchange Server 2007.

Parameter properties

Type:

String[][]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

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

-ProtectionGroup

Specifies a protection group on which this cmdlet operates. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.

Parameter properties

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

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Remove

Indicates that this cmdlet performs a remove operation.

Parameter properties

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

Parameter sets

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

-RunEseUtilConsistencyCheck

Indicates that the cmdlet runs Eseutil consistency checking. This parameter applies only to Exchange Server data sources.

Parameter properties

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

Parameter sets

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

-TopologyType

Specifies the topology type.

The acceptable values for this parameter are:

  • Active
  • Passive
  • Active if Passive Not Available

This parameter applies only to Microsoft Exchange Server 2007 installations that run cluster continuous replication.

Parameter properties

Type:ProtectionTopologyType
Default value:None
Accepted values:PT_CCR_PHYSICAL_NODE, PT_CCR_ACTIVE_ONLY, PT_CCR_PASSIVE_ONLY, PT_CCR_ACTIVE_IF_NO_PASSIVE
Supports wildcards:False
DontShow:False

Parameter sets

ExchangeOptions
Position:3
Mandatory:False
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.

Outputs

Datasource