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 $mpgMigrating 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 |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | 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 |
| Required: | True |
| 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 |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
| Required: | True |
| 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 |
| Required: | True |
| 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 |
| Required: | True |
| 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 |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FormatVolumes
Indicates that DPM formats the allocated volumes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Manual
Indicates that you can apply DPM settings manually.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
| Required: | True |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProductionServerJournalSize
Specifies the journal size of the protected server.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | True |
| 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 |
| Required: | 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 |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Outputs
Datasource