This is an archive version of the document. To get the most up-to-date information, see the
current version.
New-VBRViVirtualDeviceMappingRule
Defines backed-up virtual disk mapping settings.
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
New-VBRViVirtualDeviceMappingRule -SourceVirtualDevice <VBRViVirtualDevice> [-Datastore <CViDatastoreItem>] [<CommonParameters>] |
This cmdlet defines mapping settings of backed-up virtual disks.
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
|---|
SourceVirtualDevice | Specifies backed-up virtual disks. The cmdlet will map these disks to the datastore. | Accepts the VBRViVirtualDevice object. To create this object, run the Get-VBRViVirtualDevice cmdlet. | True | Named | True (ByValue, ByPropertyName) |
Datastore | Specifies a datastore. The cmdelt will map backed-up virtual disks to this datastore. Note: If you do not specify this parameter, the cmdlet will will attach backed-up virtual disks to the default datastore. | Accepts the CViDatastoreItem object. To create this object, run the Find-VBRViDatastore cmdlet. | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.
The cmdlet returns the VBRViVirtualDeviceMappingRule object that defines defines backed-up virtual disks mapping settings.
This example shows how to map the backed-up virtual disks to the default datastore. The cmdlet will attach virtual disks of the VM that is backed up by the Winsrv4515 job. $backup = Get-VBRBackup -Name "Winsrv4515" $restorepoint = Get-VBRRestorePoint -Backup $backup $disks = Get-VBRViVirtualDevice -RestorePoint $restorepoint[3] New-VBRViVirtualDeviceMappingRule -SourceVirtualDevice $disks |
Perform the following steps: - Get the backed-up VM virtual disks:
- Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
- Run the Get-VBRRestorePoint cmdlet. Specify the Backup parameter value. Save the result to the $restorepoint variable.
- Run the Get-VBRViVirtualDevice cmdlet. Specify the RestorePoint parameter value. Save the result to the $disks variable.
The Get-VBRRestorePoint cmdlet will return an array of restore points. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore session in the array). - Run the New-VBRViVirtualDeviceMappingRule cmdlet. Set the $disks variable as the SourceVirtualDevice parameter value.
|
Example 2. Mapping Backed-Up Virtual Disks to Specific Datastore
This example shows how to map the backed-up virtual disks to the LocalStore_0 datastore. This datastore is connected to the WinSrv2073 server. The cmdlet will map virtual disks of the VM that is backed up by the Winsrv4515 job. $backup = Get-VBRBackup -Name "Winsrv4515" $restorepoint = Get-VBRRestorePoint -Backup $backup $disks = Get-VBRViVirtualDevice -RestorePoint $restorepoint[3] $server = Get-VBRServer -Name "WinSrv2073" $datastore = Find-VBRViDatastore -Server $server -Name "LocalStore_0" New-VBRViVirtualDeviceMappingRule -SourceVirtualDevice $disks -Datastore $datastore |
Perform the following steps: - Get the backed-up VM virtual disks:
- Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
- Run the Get-VBRRestorePoint cmdlet. Specify the Backup parameter value. Save the result to the $restorepoint variable.
The Get-VBRRestorePoint cmdlet will return an array of restore points. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore session in the array). - Run the Get-VBRViVirtualDevice cmdlet. Specify the RestorePoint parameter value. Save the result to the $disks variable.
- Get the datastore:
- Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable
- Run the Find-VBRViDatastore cmdlet. Specify the Name and Server parameter values. Save the result to the $datastore variable.
- Run the New-VBRViVirtualDeviceMappingRule cmdlet. Set the $disks variable as the SourceVirtualDevice parameter value. Set the $datastore variable as the Datastore parameter value.
|
Related Commands
