Set-DPMDatasourceDiskAllocation

Changes disk allocation for protected data.

Syntax

Set-DPMDatasourceDiskAllocation
   [-Datasource] <Datasource>
   [-ProtectionGroup] <ProtectionGroup>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceDiskAllocation
   [-Datasource] <Datasource>
   [-ProtectionGroup] <ProtectionGroup>
   [-Manual]
   [-ReplicaArea <Int64>]
   [-ShadowCopyArea <Int64>]
   [-ProductionServerJournalSize <Int64>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceDiskAllocation
   [-Datasource] <Datasource>
   [-ProtectionGroup] <ProtectionGroup>
   [-MigrateDatasourceDataFromDPM]
   [-DestinationReplicaVolume] <DpmServerVolume>
   [-DestinationShadowCopyVolume] <DpmServerVolume>
   [-FormatVolumes]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceDiskAllocation
   [[-Datasource] <Datasource>]
   [-ProtectionGroup] <ProtectionGroup>
   [-ShadowCopyArea <Int64>]
   -ExpectedDataSizePerClientInMB <Int64>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceDiskAllocation
   [-Datasource] <Datasource>
   [-ProtectionGroup] <ProtectionGroup>
   [-TargetStorage] <Volume>
   [-ReplicaArea <Int64>]
   [-ExpectedDataSizePerClientInMB <Int64>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceDiskAllocation
   [-Datasource] <Datasource>
   [-ProtectionGroup] <ProtectionGroup>
   [-CustomRequirements]
   [-ReplicaVolume <DpmServerVolume>]
   [-ShadowCopyVolume <DpmServerVolume>]
   [-FormatVolumes]
   [-USNJournalSize <Int64>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceDiskAllocation
   [-Datasource] <Datasource>
   [-ProtectionGroup] <ProtectionGroup>
   [-MigrateDatasourceDataFromDPM]
   [-DestinationDiskPool] <Disk[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMDatasourceDiskAllocation
   [-ProtectionGroup] <ProtectionGroup>
   [-AutoGrow] <Boolean>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-DPMDatasourceDiskAllocation cmdlet changes disk allocation for protected data. By default, System Center 2016 - Data Protection Manager (DPM) allocates disk space and volumes for the data source. The cmdlet gives you the following options for changing disk allocation:

  • Specify the amount of disk space to allocate to each data source in a protection group.
  • Specify the custom replica and shadow copy volumes to use for each data source in a protection group.
  • Specify the target volume for each data source in a protection group which uses volume-based storage.
  • Specify destination disk or custom volumes for migration of data.

Examples

1: Migrate a datasource from one volume to another

PS C:\>$pg = Get-DPMProtectionGroup
	PS C:\>$mpg = Get-DPMModifiableProtectionGroup $pg[0]
 PS C:\>$ds = Get-DPMDatasource $mpg
 PS C:\>$vols = Get-DPMDiskStorage -Volumes
 PS C:\>Set-DPMDatasourceDiskAllocation -ProtectionGroup $mpg -Datasource $ds[0] -TargetStorage $vols[0] -MigrateDatasourceDataFromDPM
 PS C:\>Set-ProtectionGroup $mpg

Migrating a datasource involves modifying the PG the datasource is in. The first command gets the protection group object from DPM. The second command converts it into a modifiable protection group, $mpg. The third command gets the datasources that are a part of the modifiable protection group. Next, $vols stores all the available volumes. If $ds[0] needs to migrated to $vols[0], the next command instructs DPM to modify the PG to change the volume allocated to the datasource The last command then saves all the above actions performed on the Protection Group.

Parameters

-AutoGrow

Indicates whether DPM increases the size of the replica or recovery point volume automatically when it runs out of user space.

Type:Boolean
Position:2
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-CustomRequirements

Indicates that you can specify replica and shadow copy volumes manually.

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

Specifies a data source object for which this cmdlet modifies disk allocation. A data source can be a file system share or volume for the Windows operating system, Microsoft SQL Server database, Microsoft Exchange Server storage group, Microsoft SharePoint farm, Microsoft Virtual Machine, DPM database, or system state that is a member of a protection group.

Type:Datasource
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-DestinationDiskPool

Specifies the set of disks on which DPM allocates volumes to migrate a data source. This parameter is migration specific.

Type:Disk[]
Position:4
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DestinationReplicaVolume

Specifies the destination volume that the user allocates to migrate replicas of a data source. This parameter is migration specific.

Type:DpmServerVolume
Position:4
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DestinationShadowCopyVolume

Specifies the destination volume that the user allocates to migrate shadow copies of a data source. This parameter is migration specific.

Type:DpmServerVolume
Position:5
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ExpectedDataSizePerClientInMB

Specifies the expected size, in megabytes, of data that DPM backs up from each client computer.

Type:Int64
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-FormatVolumes

Indicates that DPM formats the allocated volumes.

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

Indicates that you can apply DPM settings manually.

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

Indicates that DPM migrates the data source from the current volumes to a new set of volumes.

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

Specifies the journal size of the protected server.

Type:Int64
Position:Named
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
Position:2
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-ReplicaArea

Specifies the disk allocation for the replica area of the current data source.

Type:Int64
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ReplicaVolume

Specifies a replica volume object. A replica volume is a volume on the DPM server that contains the replica of a protected data source.

Type:DpmServerVolume
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ShadowCopyArea

Specifies the disk allocation for the shadow copy area of the current data source.

Type:Int64
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ShadowCopyVolume

Specifies an object for a shadow copy volume. This object represents the volume that contains the shadow copy.

Type:DpmServerVolume
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TargetStorage

Specifies a volume in the DPM storage pool that will be used to store the replica virtual hard disk (VHD) for the current data source.

Type:Volume
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-USNJournalSize

Specifies the journal size for the update sequence number (USN).

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

Outputs

Datasource