< Back
Get-SVTbackup
Post
NAME Get-SVTbackup
SYNOPSIS
Display information about HPE SimpliVity backups.
SYNTAX
Get-SVTbackup [-Hour <String>] [-Latest] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-VMName] <String>] [-Hour <String>] [-Latest] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-DatastoreName] <String>] [-Hour <String>] [-Latest] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-ClusterName] <String>] [-Hour <String>] [-Latest] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-BackupName] <String>] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-All]] [-Latest] [-Limit <Int32>] [<CommonParameters>]
DESCRIPTION
Show backup information from the HPE SimpliVity Federation. By default SimpliVity backups from the last 24 hours
are
shown, but this can be overridden by specifying the -Hour parameter. Alternatively, specify VM name, Cluster name,
or Datacenter name (with or without -Hour) to filter backups appropriately.
You can use the -Latest parameter to display (one of) the latest backups for each VM. (Be careful, a policy may
have more than one rule
to backup to different detinations - only one of the backups is shown).
Use the -Limit parameter to limit the number of backups shown. There is a known issue where setting the limit
above 3000 can result in out of
memory errors, so the -Limit parameter can currently be set between 1 and 3000. The recommended default of 500 is
used. A warning is displayed
if the number of backups in the environment exceeds the limit for a specific Get-SVTbackup command.
Verbose is automatically turned on to show more information about what this command is doing.
PARAMETERS
-VMName <String>
Show backups for the specified virtual machine only.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DatastoreName <String>
Show backups from the specified Simplivity datastore only.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ClusterName <String>
Show backups from the specified HPE SimpliVity cluster only.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-BackupName <String>
Show backups from the specified backup name.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-All [<SwitchParameter>]
Show all backups. The maximum limit of 3000 is assumed, so this command might take a while depending on the
number of backups in the environment.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Hour <String>
The number of hours preceeding to report on. By default, the last 24 hours of backups are shown.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Latest [<SwitchParameter>]
Show (one of) the latest backup for every unique virtual machine.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Limit <Int32>
There is a known performance issue with /backups API. HPE recommends 500 default, 3000 maximum (OMNI-53190)
Required? false
Position? named
Default value 500
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
OUTPUTS
HPE.SimpliVity.Backup
NOTES
Known issues with the REST API Get operations for Backup objects:
OMNI-53190 REST API Limit recommendation for REST GET backup object calls
OMNI-46361 REST API GET operations for backup objects and sorting and filtering constraints
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Get-SVTbackup
Show the last 24 hours of backups from the SimpliVity Federation
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-SVTbackup -Hour 48 | Select-Object VMname, DataStoreName, SentMB, UniqueSizeMB | Format-Table -Autosize
Show backups up to 48 hours old and select specific properties to display
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Get-SVTbackup -BackupName '2019-05-05T00:00:00-04:00'
Shows the backup(s) with the specified backup name
-------------------------- EXAMPLE 4 --------------------------
PS C:\\>Get-SVTbackup -All
Shows all backups. This might take a while to complete (Limit is set to 3000, overriding a specified Limit)
-------------------------- EXAMPLE 5 --------------------------
PS C:\\>Get-SVTbackup -Latest
Show the last backup for every VM.
-------------------------- EXAMPLE 6 --------------------------
PS C:\\>Get-SVTbackup -VMname MyVM
Shows backups in the last 24 hours for the specified VM only.
-------------------------- EXAMPLE 7 --------------------------
PS C:\\>Get-SVTbackup -Datastore MyDatastore
Shows all backups on the specified datastore.
RELATED LINKS
SYNOPSIS
Display information about HPE SimpliVity backups.
SYNTAX
Get-SVTbackup [-Hour <String>] [-Latest] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-VMName] <String>] [-Hour <String>] [-Latest] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-DatastoreName] <String>] [-Hour <String>] [-Latest] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-ClusterName] <String>] [-Hour <String>] [-Latest] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-BackupName] <String>] [-Limit <Int32>] [<CommonParameters>]
Get-SVTbackup [[-All]] [-Latest] [-Limit <Int32>] [<CommonParameters>]
DESCRIPTION
Show backup information from the HPE SimpliVity Federation. By default SimpliVity backups from the last 24 hours
are
shown, but this can be overridden by specifying the -Hour parameter. Alternatively, specify VM name, Cluster name,
or Datacenter name (with or without -Hour) to filter backups appropriately.
You can use the -Latest parameter to display (one of) the latest backups for each VM. (Be careful, a policy may
have more than one rule
to backup to different detinations - only one of the backups is shown).
Use the -Limit parameter to limit the number of backups shown. There is a known issue where setting the limit
above 3000 can result in out of
memory errors, so the -Limit parameter can currently be set between 1 and 3000. The recommended default of 500 is
used. A warning is displayed
if the number of backups in the environment exceeds the limit for a specific Get-SVTbackup command.
Verbose is automatically turned on to show more information about what this command is doing.
PARAMETERS
-VMName <String>
Show backups for the specified virtual machine only.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DatastoreName <String>
Show backups from the specified Simplivity datastore only.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ClusterName <String>
Show backups from the specified HPE SimpliVity cluster only.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-BackupName <String>
Show backups from the specified backup name.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-All [<SwitchParameter>]
Show all backups. The maximum limit of 3000 is assumed, so this command might take a while depending on the
number of backups in the environment.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Hour <String>
The number of hours preceeding to report on. By default, the last 24 hours of backups are shown.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Latest [<SwitchParameter>]
Show (one of) the latest backup for every unique virtual machine.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Limit <Int32>
There is a known performance issue with /backups API. HPE recommends 500 default, 3000 maximum (OMNI-53190)
Required? false
Position? named
Default value 500
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
OUTPUTS
HPE.SimpliVity.Backup
NOTES
Known issues with the REST API Get operations for Backup objects:
OMNI-53190 REST API Limit recommendation for REST GET backup object calls
OMNI-46361 REST API GET operations for backup objects and sorting and filtering constraints
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Get-SVTbackup
Show the last 24 hours of backups from the SimpliVity Federation
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Get-SVTbackup -Hour 48 | Select-Object VMname, DataStoreName, SentMB, UniqueSizeMB | Format-Table -Autosize
Show backups up to 48 hours old and select specific properties to display
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Get-SVTbackup -BackupName '2019-05-05T00:00:00-04:00'
Shows the backup(s) with the specified backup name
-------------------------- EXAMPLE 4 --------------------------
PS C:\\>Get-SVTbackup -All
Shows all backups. This might take a while to complete (Limit is set to 3000, overriding a specified Limit)
-------------------------- EXAMPLE 5 --------------------------
PS C:\\>Get-SVTbackup -Latest
Show the last backup for every VM.
-------------------------- EXAMPLE 6 --------------------------
PS C:\\>Get-SVTbackup -VMname MyVM
Shows backups in the last 24 hours for the specified VM only.
-------------------------- EXAMPLE 7 --------------------------
PS C:\\>Get-SVTbackup -Datastore MyDatastore
Shows all backups on the specified datastore.
RELATED LINKS