< Back
New-SVTbackup
Post
NAME New-SVTbackup
SYNOPSIS
Create one or more new HPE SimpliVity backups
SYNTAX
New-SVTbackup [-VMname] <String> [[-ClusterName] <String>] [[-BackupName] <String>] [[-RetentionDay] <Int32>]
[[-AppConsistent]] [[-ConsistencyType] <String>] [<CommonParameters>]
DESCRIPTION
Creates a backup of one or more virtual machines hosted on HPE SimpliVity. Either specify the VM names via the
VMname parameter or use Get-SVTvm output to pipe in the HPE SimpliVity VM objects to backup. Backups are directed
to the
specified destination cluster, or to the local cluster for each VM if no destination cluster name is specified.
PARAMETERS
-VMname <String>
The virtual machine(s) to backup
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-ClusterName <String>
The destination cluster name. If nothing is specified, the virtual machine(s) is/are backed up locally.
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-BackupName <String>
Give the backup(s) a unique name, otherwise a date stamp is used.
Required? false
Position? 3
Default value "Created by $($global:SVTconnection.Credential.Username) at $(Get-Date -Format
'yyyy-MM-dd hh:mm:ss')"
Accept pipeline input? false
Accept wildcard characters? false
-RetentionDay <Int32>
Retention specified in days. The default is 1 day.
Required? false
Position? 4
Default value 1
Accept pipeline input? false
Accept wildcard characters? false
-AppConsistent [<SwitchParameter>]
An indicator to show if the backup represents a snapshot of a virtual machine with data that was first flushed
to disk.
Default is false. This is a switch parameter, true if present.
Required? false
Position? 5
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-ConsistencyType <String>
There are two available options to create application consistant backups:
1. VMware Snapshot - This is the default method used for application consistancy
2. Microsoft VSS - refer to the admin guide for requirements and supported applications
There is also the option to not use application consistancy (None). This is the default for this command.
Required? false
Position? 5
Default value NONE
Accept pipeline input? false
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.VirtualMachine
OUTPUTS
HPE.SimpliVity.Task
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>New-SVTbackup -VMname MyVM -ClusterName ClusterDR
Backup the specified VM to the specified SimpliVity cluster, using the default backup name and retention
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-SVTvm | ? VMname -match '^DB' | New-SVTbackup -BackupName 'Manual backup prior to SQL upgrade'
Locally backup up all VMs with names starting with 'DB' using the the specified backup name and default retention
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>'vm01','vm02','vm03' | New-SVTvm -BackupName 'Long term backup' -ClusterName MyCluster -RetentionDay 90
PS C:\\> Get-SVTtask
Backup the specified VMs to the specified cluster and with a retention of 90 days. Second command monitors the
three backup tasks.
RELATED LINKS
SYNOPSIS
Create one or more new HPE SimpliVity backups
SYNTAX
New-SVTbackup [-VMname] <String> [[-ClusterName] <String>] [[-BackupName] <String>] [[-RetentionDay] <Int32>]
[[-AppConsistent]] [[-ConsistencyType] <String>] [<CommonParameters>]
DESCRIPTION
Creates a backup of one or more virtual machines hosted on HPE SimpliVity. Either specify the VM names via the
VMname parameter or use Get-SVTvm output to pipe in the HPE SimpliVity VM objects to backup. Backups are directed
to the
specified destination cluster, or to the local cluster for each VM if no destination cluster name is specified.
PARAMETERS
-VMname <String>
The virtual machine(s) to backup
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-ClusterName <String>
The destination cluster name. If nothing is specified, the virtual machine(s) is/are backed up locally.
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-BackupName <String>
Give the backup(s) a unique name, otherwise a date stamp is used.
Required? false
Position? 3
Default value "Created by $($global:SVTconnection.Credential.Username) at $(Get-Date -Format
'yyyy-MM-dd hh:mm:ss')"
Accept pipeline input? false
Accept wildcard characters? false
-RetentionDay <Int32>
Retention specified in days. The default is 1 day.
Required? false
Position? 4
Default value 1
Accept pipeline input? false
Accept wildcard characters? false
-AppConsistent [<SwitchParameter>]
An indicator to show if the backup represents a snapshot of a virtual machine with data that was first flushed
to disk.
Default is false. This is a switch parameter, true if present.
Required? false
Position? 5
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-ConsistencyType <String>
There are two available options to create application consistant backups:
1. VMware Snapshot - This is the default method used for application consistancy
2. Microsoft VSS - refer to the admin guide for requirements and supported applications
There is also the option to not use application consistancy (None). This is the default for this command.
Required? false
Position? 5
Default value NONE
Accept pipeline input? false
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.VirtualMachine
OUTPUTS
HPE.SimpliVity.Task
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>New-SVTbackup -VMname MyVM -ClusterName ClusterDR
Backup the specified VM to the specified SimpliVity cluster, using the default backup name and retention
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-SVTvm | ? VMname -match '^DB' | New-SVTbackup -BackupName 'Manual backup prior to SQL upgrade'
Locally backup up all VMs with names starting with 'DB' using the the specified backup name and default retention
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>'vm01','vm02','vm03' | New-SVTvm -BackupName 'Long term backup' -ClusterName MyCluster -RetentionDay 90
PS C:\\> Get-SVTtask
Backup the specified VMs to the specified cluster and with a retention of 90 days. Second command monitors the
three backup tasks.
RELATED LINKS