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> {AddInclude | RemoveInclude | AddExclude | RemoveExclude} [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ExchangeOptions
Set-DPMDatasourceProtectionOption [-ProtectionGroup] <ProtectionGroup> [[-TopologyType] <ProtectionTopologyType> {PT_CCR_PHYSICAL_NODE | PT_CCR_ACTIVE_ONLY | PT_CCR_PASSIVE_ONLY | PT_CCR_ACTIVE_IF_NO_PASSIVE} ] [[-PreferredPhysicalNode] <String[][]> ] -ExchangeOptions [-BackUpType <AllowedBackupTypeType> {FullBackup | CopyBackup} ] [-Datasource <Datasource> ] [-EseutilCheckType <EseutilTypeType> {DontRun | RunOnLogs | RunOnLogsAndDB} ] [-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 from protection.
-- Remove exclusions.
-- Set protection options for a Microsoft Exchange Server 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 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 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 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.
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 Server database repair tool Eseutil. Valid values are:
-- DontRun
-- RunOnLogs
-- RunOnLogsAndDB
Aliases |
none |
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.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-FileType<String>
Specifies 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
Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Path<String>
Specifies the path of 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 on which this cmdlet operates. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.
Aliases |
none |
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.
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 Exchange Server 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 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
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.
PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> Set-DPMDatasourceProtectionOption -ProtectionGroup $PGroup -AutoConsistencyCheck $True