New HPOVBackup - HewlettPackard/POSH-HPEOneView GitHub Wiki
Generate and download or remote save appliance backup.
New-HPOVBackup [-Location] <String>[ [-Force] <SwitchParameter>][ [-Async] <SwitchParameter>] [-ApplianceConnection] <Array> [<CommonParameters>]HPE OneView provides the ability to save your configuration settings and management data to a backup file and enables you to use that backup to restore a corrupted appliance in the event of a catastrophic failure.
The backup process involves creating a backup file and then downloading that file so that you can store it to a safe and secure (off-appliance) location for future use. You can schedule automatic backup operations and designate a remote location for the backup file.
Use this cmdlet to generate and download an appliance configuration backup file for backup purposes. The backup file does not contain user account passwords. The backup file is not meant to restore to other appliance for quick provisioning, as it is an encrypted TAR GZIP file.
If an automatic backup policy is configured on the appliance, the Cmdlet is instruct the appliance to offload the newly created backup to the remote location. If you wish to download the backup, use the -Location and -Force parameters, which will initiate a download to the value provided.
-ApplianceConnection <Array>
Aliases [-Appliance]
Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s).
Default Value: ${Global:ConnectedSessions} | ? Default
| Aliases | Appliance |
| Required? | true |
| Position? | named |
| Default value | (${Global:ConnectedSessions} | ? Default) |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Async <SwitchParameter>
Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.
| Aliases | None |
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Force <SwitchParameter>
The Cmdlet will validate if the appliance is configured to save backup files to a remote location. Use this option to force download the backup file instead of copying to the remote location.
| Aliases | None |
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Location <String>
Aliases [-save]
The full path to where the Support Dump will be saved to. The downloaded file name will be generated by the appliance. If the directory does not exist, it will be created. By default will use current directory.
| Aliases | save |
| Required? | true |
| Position? | named |
| Default value | (get-location).Path |
| 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 (http://go.microsoft.com/fwlink/?LinkID=113216)
None. You cannot pipe objects to this cmdlet.
The generated backup File if appliance is not setup for remote storage or the Force parameter is used.
HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject]
Async task to create the backup file.
-------------------------- EXAMPLE 1 --------------------------New-HPOVBackup
This command will generate a new backup, and if a remote location is configured, will initiate the file transfer. If not configured, then the Cmdlet will download the file to the current working directory.
-------------------------- EXAMPLE 2 --------------------------New-HPOVBackup "c: emp" -Force
This command will save the Appliance backup file to C: emp
Generate and download or remote save appliance backup.
New-HPOVBackup [-Location] <String>[ [-Force] <SwitchParameter>][ [-Async] <SwitchParameter>] [-ApplianceConnection] <Array> [<CommonParameters>]HPE OneView provides the ability to save your configuration settings and management data to a backup file and enables you to use that backup to restore a corrupted appliance in the event of a catastrophic failure.
The backup process involves creating a backup file and then downloading that file so that you can store it to a safe and secure (off-appliance) location for future use. You can schedule automatic backup operations and designate a remote location for the backup file.
Use this cmdlet to generate and download an appliance configuration backup file for backup purposes. The backup file does not contain user account passwords. The backup file is not meant to restore to other appliance for quick provisioning, as it is an encrypted TAR GZIP file.
If an automatic backup policy is configured on the appliance, the Cmdlet is instruct the appliance to offload the newly created backup to the remote location. If you wish to download the backup, use the -Location and -Force parameters, which will initiate a download to the value provided.
-ApplianceConnection <Array>
Aliases [-Appliance]
Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s).
Default Value: ${Global:ConnectedSessions} | ? Default
| Aliases | Appliance |
| Required? | true |
| Position? | named |
| Default value | (${Global:ConnectedSessions} | ? Default) |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Async <SwitchParameter>
Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.
| Aliases | None |
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Force <SwitchParameter>
The Cmdlet will validate if the appliance is configured to save backup files to a remote location. Use this option to force download the backup file instead of copying to the remote location.
| Aliases | None |
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Location <String>
Aliases [-save]
The full path to where the Support Dump will be saved to. The downloaded file name will be generated by the appliance. If the directory does not exist, it will be created. By default will use current directory.
| Aliases | save |
| Required? | true |
| Position? | named |
| Default value | (get-location).Path |
| 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 (http://go.microsoft.com/fwlink/?LinkID=113216)
None. You cannot pipe objects to this cmdlet.
The generated backup File if appliance is not setup for remote storage or the Force parameter is used.
HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject]
Async task to create the backup file.
-------------------------- EXAMPLE 1 --------------------------New-HPOVBackup
This command will generate a new backup, and if a remote location is configured, will initiate the file transfer. If not configured, then the Cmdlet will download the file to the current working directory.
-------------------------- EXAMPLE 2 --------------------------New-HPOVBackup "c:\temp" -Force
This command will save the Appliance backup file to C:\Temp