Set-DPMDatasourceProtectionOption

Set-DPMDatasourceProtectionOption

Sets protection options for a DPM data source.

Syntax

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

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

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

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

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

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

Detailed Description

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

-- Exclude all files of a particular type (for example, all MP3 files) from protection.
-- Remove exclusions.
-- Set protection options for a Microsoft Exchange data source.

Parameters

-Add

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AllowClientUserToAddFileSpecs<Boolean>

Indicates whether the user can specify which folders to protect.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AutoConsistencyCheck<Boolean>

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

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-BackUpType<AllowedBackupTypeType>

Indicates the type of backup. Valid values for this parameter are:

-- CopyBackup
-- FullBackup.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ClientFileSpecOperation<ClientFileSpecOperationType>

Indicates which folders to add to the inclusion list or remove from the exclusion list. Valid values for this parameter are:

-- AddInclude
-- RemoveInclude
-- AddExclude
-- RemoveExclude

Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Datasource<Datasource>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EseutilCheckType<EseutilTypeType>

Indicates how to run the Exchange database repair tool Eseutil. Valid values for this parameter are:

-- DontRun
-- RunOnLogs
-- RunOnLogsAndDB.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ExchangeOptions

Indicates that the options that follow affect only Microsoft Exchange data sources.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-FileType<String>

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

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PassThru

Indicates that the cmdlet generates output. By default, this cmdlet does not generate output. You can use the PassThru parameter in order to use the cmdlet in a pipeline.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Path<String>

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

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PreferredPhysicalNode<String[]>

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.

Aliases

none

Required?

false

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProtectionGroup<ProtectionGroup>

Specifies a protection group object.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Remove

Indicates that the cmdlet performs a remove operation.

Aliases

none

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 Microsoft Exchange data sources.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TopologyType<ProtectionTopologyType>

Specifies the topology type. Valid 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.

Aliases

none

Required?

false

Position?

3

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.

  • Datasource

Examples

Example 1: Set a consistency check for a protection group

This example sets a consistency check for a protection group.

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

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

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

Get-DPMDatasourceProtectionOption