Set-DPMDatasourceProtectionOption

Sets protection options for a DPM data source.

Syntax

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

Description

The Set-DPMDatasourceProtectionOption cmdlet sets protection options for a System Center 2016 - 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
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowClientUserToAddFileSpecs

Indicates whether the user can specify which folders to protect.

Type:Boolean
Required:True
Position:2
Default value:None
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
Required:True
Position:2
Default value:None
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
Parameter Sets:FullBackup, CopyBackup
Required:False
Position:Named
Default value:None
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
Parameter Sets:AddInclude, RemoveInclude, AddExclude, RemoveExclude
Required:True
Position:3
Default value:None
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
Required:False
Position:Named
Default value:None
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
Parameter Sets:DontRun, RunOnLogs, RunOnLogsAndDB
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ExchangeOptions

Indicates that this cmdlet operates on Exchange Server data sources.

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

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

Type:String
Required:True
Position:2
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:True
Position:2
Default value:None
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[][]
Required:False
Position:4
Default value:None
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
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Remove

Indicates that this cmdlet performs a remove operation.

Type:SwitchParameter
Required:True
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Parameter Sets:PT_CCR_PHYSICAL_NODE, PT_CCR_ACTIVE_ONLY, PT_CCR_PASSIVE_ONLY, PT_CCR_ACTIVE_IF_NO_PASSIVE
Required:False
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
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.

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

Outputs

Datasource