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