Short Description
Modifies a backup repository.
Applies to
Platform: VMware, Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus
Syntax
Set-VBRBackupRepository -Repository <CBackupRepository> [-Name <string>] [-Description <string>] [-MountServer <CHost>] [-Server <CHost>] [-RotatedDrive] [-EnableVPowerNFS] [-VPowerNFSFolder <string>] [-DDServerName <string>] [-RequireAccessCreds] [-Credentials <CCredentials>] [-LimitConcurrentJobs] [-MaxConcurrentJobs <int>] [-LimitDatarate] [-DataRateLimit <int>] [-AlignDataBlocks] [-DecompressDataBlocks] [-UsePerVMFile] [-DDBoostEncryptionType <VBRDDBoostEncryptionType> {None | Medium | High}] [-AffinityMode <VBRProxyAffinityMode> {Auto | Manual}] [-AffinityProxy <CViProxy[]>] [<CommonParameters>] |
Detailed Description
This cmdlet modifies a selected backup repository.
To modify scale-out backup repository, run Set-VBRScaleOutBackupRepository.
To modify settings, enter the necessary parameters with new values. The parameters that you omit will remain unchanged.
Parameters
Parameter | Description | Required | Position | Accept | Accept |
Repository | Specifies the backup repository you want to modify. | True | Named | True (ByValue, | False |
Name | Specifies the name you want to assign to the backup repository. | False | Named | False | False |
Description | Specifies the description of the backup repository. | False | Named | False | False |
Server | Specifies the host where the backup repository you want to add is located. Use this parameter to explicitly set the host for the following repository types:
Default: This server. | False | Named | False | False |
Mount | Specifies the mount server associated with the backup repository. You can assign the mount server role to the backup repository itself or to a server that resides close to the backup repository. | False | Named | False | False |
Rotated | Indicates that the repository you want to add is a rotated drive (removable media). | False | Named | False | False |
Enable | Indicates that the repository is accessible by the vPower NFS service. | False | Named | False | False |
VPower | Specifies the path to the vPower NFS root folder. | False | Named | False | False |
DDServer | Specifies the Data Domain server name. Enter the name in the following formats depending on the connection mode:
| False | Named | False | False |
Require | Indicates that the administrator credentials are needed to access the shared folder. Use the Credentials parameter to specify the credentials. | False | Named | False | False |
Credentials | Specifies credentials you want to use for authenticating with the backup repository host. | False | Named | False | False |
Limit | Enables the limit of the concurrent jobs for the backup repository that you want to add. Use the MaxConcurrentJobs parameter, to set the maximum tasks value. | False | Named | False | False |
Max | For the LimitConcurrentJobs parameter. Specifies the maximum allowed number of concurrent tasks for the backup repository. Permitted values: 1 to 99. | False | Named | False | False |
Limit | Enables the limit for the data read and write speed to/from the backup repository. NOTE: To set the maximum speed value, use the DataRateLimit parameter. | False | Named | False | False |
Data | Specifies the maximum value for the data read and write speed. Permitted value: 1 to 1024 (MByte/s). NOTE: To apply the maximum speed value, you must use the LimitDatarate parameter. | False | Named | False | False |
Align | Indicates that the backup blocks size will be aligned by a 4Kb block boundary. Data alignment provides better deduplication on storage systems with fixed block size. | False | Named | False | False |
Decompress | Indicates that the backup data blocks must be decompressed before storing to the repository. | False | Named | False | False |
UsePerVM | Indicates that the backup repository must create per-VM backup files. | False | Named | False | False |
DDBoost | Specifies the native Dell EMC Data Domain encryption level:
| False | Named | False | False |
AffinityMode | Specifies what proxy affinity rules are set up for the backup repository:
To configure proxy affinity settings, you must install Veeam Backup & Replication Enterprise or higher license on the backup server. Default: Auto. | False | Named | False | False |
AffinityProxy | Specifies the list of backup proxies that can work with the backup repository. Entries in the proxy affinity list are separated with a comma. To configure proxy affinity settings, you must install Veeam Backup & Replication Enterprise or higher license on the backup server. | False | Named | True (ByValue, | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.
Example 1
This example shows how to configure proxy affinity settings for a backup repository.
You will need to perform the following steps:
- Run Get-VBRBackupRepository to get the backup repository and save it to the $repository variable.
- Run Get-VBRViProxy twice to get backup proxies and save them to the $proxy01 and $proxy02 variables.
- Run Set-VBRBackupRepository with the $repository, $proxy01 and proxy02 variables.
PS C:\PS> $repository = Get-VBRBackupRepository -Name "Backup Volume 01" PS C:\PS> $proxy01 = Get-VBRViProxy -Name 172.17.53.5 PS C:\PS> $proxy02 = Get-VBRViProxy -Name 172.17.53.33 PS C:\PS> Set-VBRBackupRepository -Repository $repository -AffinityMode manual -AffinityProxy $proxy01, $proxy02 |
Example 2
The example shows how to modify the maximum allowed number of concurrent tasks for the particular scale-out repository extent.
You will need to perform the following steps:
- Run Get-VBRRepositoryExtent to get the array of the extents. Save the result to the $scaleoutrepository variable.
- Get the required extent. Use the .repository property of the scale-out repository extent object to get the extent you want to modify. Save the result to the $extent variable.
- Run Set-VBRBackupRepository with the $extent variable. Use the MaxConcurrentJobs parameter to specify the number of concurrent tasks.
PS C:\PS> $scaleoutrepository = Get-VBRRepositoryExtent -Repository "ScaleOutRepository" PS C:\PS> $extent = $scaleoutrepository[0].repository PS C:\PS> Set-VBRBackupRepository -Repository $extent -LimitConcurrentJobs -MaxConcurrentJobs 9 |
Related Commands