< Back
Restore-SVTvm
Post
NAME Restore-SVTvm
SYNOPSIS
Restore one or more HPE SimpliVity virtual machines
SYNTAX
Restore-SVTvm [-RestoreToOriginal] -BackupId <String> [<CommonParameters>]
Restore-SVTvm [-VMname] <String> [-DataStoreName] <String> -BackupId <String> [<CommonParameters>]
DESCRIPTION
Restore one or more virtual machines hosted on HPE SimpliVity. Use Get-SVTbackup output to pipe in the
backup ID(s) and VMname(s) you'd like to restore. You can either specify a destination datastore or restore
to the local datastore for each specified backup. By default, the restore will create a new VM with the
same/specified name, but with a time stamp appended, or you can specify -RestoreToOriginal switch to overwrite
the existing virtual machine.
BackupId is the only unique identifier for backup objects (e.g. multiple backups can have the same name). This
makes
using this command a little cumbersome by itself. However, you can use Get-SVTBackup to identify the backups you
want to target
and then pipe the output to this command.
PARAMETERS
-RestoreToOriginal [<SwitchParameter>]
Specifies that the existing virtual machine is overwritten
Required? true
Position? 1
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-VMname <String>
The virtual machine name(s)
Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DataStoreName <String>
The destination datastore name
Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-BackupId <String>
The UID of the backup(s) to restore from
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String
HPE.SimpliVity.Backup
OUTPUTS
HPE.SimpliVity.Task
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Get-SVTbackup -BackupName 2019-05-09T22:00:01-04:00 | Restore-SVTvm -RestoreToOriginal
Restores the virtual machine(s) in the specified backup to the original VM name(s)
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-SVTbackup -VMname MyVM | Sort-Object CreateDate | Select-Object -Last 1 | Restore-SVTvm
Restores the latest backup of specified virtual machine, giving it the name of the original VM with a data stamp
appended
RELATED LINKS
SYNOPSIS
Restore one or more HPE SimpliVity virtual machines
SYNTAX
Restore-SVTvm [-RestoreToOriginal] -BackupId <String> [<CommonParameters>]
Restore-SVTvm [-VMname] <String> [-DataStoreName] <String> -BackupId <String> [<CommonParameters>]
DESCRIPTION
Restore one or more virtual machines hosted on HPE SimpliVity. Use Get-SVTbackup output to pipe in the
backup ID(s) and VMname(s) you'd like to restore. You can either specify a destination datastore or restore
to the local datastore for each specified backup. By default, the restore will create a new VM with the
same/specified name, but with a time stamp appended, or you can specify -RestoreToOriginal switch to overwrite
the existing virtual machine.
BackupId is the only unique identifier for backup objects (e.g. multiple backups can have the same name). This
makes
using this command a little cumbersome by itself. However, you can use Get-SVTBackup to identify the backups you
want to target
and then pipe the output to this command.
PARAMETERS
-RestoreToOriginal [<SwitchParameter>]
Specifies that the existing virtual machine is overwritten
Required? true
Position? 1
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-VMname <String>
The virtual machine name(s)
Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DataStoreName <String>
The destination datastore name
Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-BackupId <String>
The UID of the backup(s) to restore from
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String
HPE.SimpliVity.Backup
OUTPUTS
HPE.SimpliVity.Task
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Get-SVTbackup -BackupName 2019-05-09T22:00:01-04:00 | Restore-SVTvm -RestoreToOriginal
Restores the virtual machine(s) in the specified backup to the original VM name(s)
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-SVTbackup -VMname MyVM | Sort-Object CreateDate | Select-Object -Last 1 | Restore-SVTvm
Restores the latest backup of specified virtual machine, giving it the name of the original VM with a data stamp
appended
RELATED LINKS