This is an archive version of the document. To get the most up-to-date information, see the current version.Start-VBRZip
Short Description
Performs VeeamZIP on the selected VM.
Applies to
Platform: VMware, Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Syntax
This cmdlet provides 2 parameter sets.
- For targeting VeeamZIP backups to a backup repository:
Start-VBRZip -Entity <IItem[]> [-BackupRepository <CBackupRepository>] [-Compression <int>] [-DisableQuiesce] [-RunAsync] [-EncryptionKey <PSCryptoKey>] [-AutoDelete <EFreeBackupRetention> {Never | Tonight | TomorrowNight | In3days | In1Week | In2Weeks | In1Month | In3Months | In6Months | In1Year}] [-Force] [<CommonParameters>] |
- For targeting VeeamZIP backups to a folder or for Veeam Backup Free Edition:
Start-VBRZip -Entity <IItem[]> [-Folder <string>] [-Compression <int>] [-DisableQuiesce] [-RunAsync] [-EncryptionKey <PSCryptoKey>] [-AutoDelete <EFreeBackupRetention> {Never | Tonight | TomorrowNight | In3days | In1Week | In2Weeks | In1Month | In3Months | In6Months | In1Year}] [-NetworkCredentials <CCredentials>] [-Force] [<CommonParameters>] |
Detailed Description
This cmdlet performs VeeamZIP backup of the selected VM.
VeeamZIP is a quick backup procedure always producing a full backup. The VeeamZIP task runs once the time it is created and does not appear in the jobs list. The result backup file is stored in the specified folder and does not appear automatically in the backups list. Run Import-VBRBackup to start managing the backup file with Veeam Backup & Replication.
This cmdlet is available for Veeam Backup Free Edition. You can use it in your scripts. For Veeam Backup Free Edition, use the second parameter set.
Starting from Veeam Backup & Replication version 9.5 Update 3, the cmdlet checks if the data of the VMs you want to back up changes its geographical location.
|
|
Parameters
Parameter | Description | Required | Position | Accept | Accept |
|---|---|---|---|---|---|
BackupRepository | Specifies the backup repository where you want to save the backup file. If none is specified, the default repository will be used. NOTE: The cmdlet will not run if you do not specify either the BackupRepository or the Folder parameters. | False | Named | False | False |
Entity | Specifies the array of VMs for which you want to create a VeeamZIP file. | True | Named | True (ByValue, | False |
Compression | Specifies then integer number corresponding to the desired compression level:
| False | Named | False | False |
DisableQuiesce | Defines that the VM will be backed up without using the quiescence mechanisms. If you provide this parameter, the cmdlet will create a crash-consistent backup of the target VM. Otherwise, the applications that run on the target VM will be quiesced to provide transactionally consistent backup. | False | Named | False | False |
RunAsync | Indicates that the command returns immediately without waiting for the task to complete. | False | Named | False | False |
Folder | Specifies the full path to the folder on the server where you want to store the created backup file. If omitted, the created backup file will be saved to the C:\backup folder on the Veeam Backup server. NOTE: The cmdlet will not run if you do not specify either the BackupRepository or the Folder parameters. | False | Named | False | False |
EncryptionKey | Specifies the encryption key you want to use to encrypt the created VeeamZIP file. | False | Named | False | False |
AutoDelete | Specifies the retention settings for the created VeeamZIP file:
| False | Named | False | False |
NetworkCredentials | Specifies the credentials you want to use for authenticating with the shared folder. | False | Named | False | False |
Force | Indicates that the cmdlet will perform backup even if the geographical location of VMs and the target backup repository location do not match. | False | Named | False | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.
Example 1
This example shows how to perform VeeamZIP backup to a backup repository.
You will need to perform the following steps:
- Run Find-VBRViEntity to get the VM where VeeamZIP will be started. Save the result to the $vm variable.
- Run Get-VBRBackupRepository to get the repository where the backups will be stored. Save the result to the $rep variable.
- Run Start-VBRZip with the $vm and $rep variables.
$vm = Find-VBRViEntity -Name "Fileserver01" $rep = Get-VBRBackupRepository -Name "Reports" Start-VBRZip -BackupRepository $rep -Entity $vm -RunAsync |
Example 2
This example shows how to perform VeeamZIP backup to a shared folder. The cmdlet starts VeeamZIP with the following parameters:
- Path to the folder where the backups will be stored is D:\Repository\VeeamZIP.
- The compression level is set to 4 (Dedupe-friendly).
- The VMware quiescence is disabled.
- The cmdlet will use "Shared" credentials for authenticating with the shared folder.
- The RunAsync parameter is set to bring the process to the background.
You will need to perform the following steps:
- Run Find-VBRViEntity to get the VM where VeeamZIP will be started. Save the result to the $vm variable.
- Run Get-VBRCredentials to get the credentials for authenticating with the shared folder. Save the result to the $netcreds variable.
- Run Start-VBRZip with the $vm and $netcreds variables.
$vm = Find-VBRViEntity -Name "Tech" $netcreds = Get-VBRCredentials -Name "Shared" Start-VBRZip -Folder "D:\Repository\VeeamZIP" -Entity $vm -Compression 4 -DisableQuiesce -NetworkCredentials $netcreds -RunAsync |
Related Commands
