Set-DPMDatasourceProtectionOption

Sets protection options for a DPM data source.

Syntax

Set-DPMDatasourceProtectionOption
   [-EseutilCheckType <EseutilTypeType>]
   [-BackUpType <AllowedBackupTypeType>]
   [[-TopologyType] <ProtectionTopologyType>]
   [[-PreferredPhysicalNode] <String[][]>]
   [-ProtectionGroup] <ProtectionGroup>
   [-Datasource <Datasource>]
   [-ExchangeOptions]
   [-RunEseUtilConsistencyCheck]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceProtectionOption
   [-ProtectionGroup] <ProtectionGroup>
   [-FileType] <String>
   [-Remove]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceProtectionOption
   [-ProtectionGroup] <ProtectionGroup>
   [-FileType] <String>
   [-Add]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceProtectionOption
   [-ProtectionGroup] <ProtectionGroup>
   [-Path] <String>
   [-ClientFileSpecOperation] <ClientFileSpecOperationType>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceProtectionOption
   [-ProtectionGroup] <ProtectionGroup>
   [-AllowClientUserToAddFileSpecs] <Boolean>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
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.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AllowClientUserToAddFileSpecs

Indicates whether the user can specify which folders to protect.

Type:Boolean
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AutoConsistencyCheck

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

Type:Boolean
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BackUpType

Indicates the type of backup.

The acceptable values for this parameter are:

  • CopyBackup
  • FullBackup
Type:AllowedBackupTypeType
Accepted values:FullBackup, CopyBackup
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Type:ClientFileSpecOperationType
Accepted values:AddInclude, RemoveInclude, AddExclude, RemoveExclude
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Datasource
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EseutilCheckType

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

The acceptable values for this parameter are:

  • DontRun
  • RunOnLogs
  • RunOnLogsAndDB
Type:EseutilTypeType
Accepted values:DontRun, RunOnLogs, RunOnLogsAndDB
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExchangeOptions

Indicates that this cmdlet operates on Exchange Server data sources.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FileType

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

Type:String
Position:2
Default value:None
Required:True
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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[][]
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProtectionGroup

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

Type:ProtectionGroup
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Remove

Indicates that this cmdlet performs a remove operation.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunEseUtilConsistencyCheck

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:ProtectionTopologyType
Accepted values:PT_CCR_PHYSICAL_NODE, PT_CCR_ACTIVE_ONLY, PT_CCR_PASSIVE_ONLY, PT_CCR_ACTIVE_IF_NO_PASSIVE
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Datasource