Set-VBRPluginCopyJobStorageOptions

In this article

    Short Description

    Modifies storage optimization settings for plug-in backup copy jobs.

    Applies to

    Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

    Syntax

    Set-VBRPluginCopyJobStorageOptions -Options <VBRPluginCopyJobStorageOptions> [-EnableDataDeduplication] [-CompressionLevel {Auto | None | DedupeFriendly | Optimal | High | Extreme}] [-StorageOptimizationType {Automatic | LocalTarget | LocalTargetHugeBackup | LANTarget | WANTarget}]  [<CommonParameters>]

    Detailed Description

    This cmdlet modifies storage optimization settings for plug-in backup copy jobs.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    Options

    Specifies optimization settings for plug-in backup copy jobs. The cmdlet will modify these settings.

    Accepts the VBRPluginCopyJobStorageOptions object. To create this object, run the New-VBRPluginCopyJobStorageOptions cmdlet.

    True

    Named

    False

    CompressionLevel

    Specifies a compression level of backup files created with a plug-in backup copy job. You can specify either of the following compression levels:

    • Auto: use this option to set the same compression level as in the copied backup files.
    • None: use this option if you do not want to enable data compression.
    • Dedupe-friendly: use this option to set a dedupe-friendly compression level.
    • Optimal: use this option to set an optimal compression level.
    • High: use this option to set a high compression level.
    • Extreme: use this option to set an extreme compression level.

    Default: Auto.

    VBRCompressionLevel

    False

    Named

    False

    StorageOptimizationType

    Specifies the type of storage that you plan to use as a backup target.

    • Automatic: use this option to set the same type of storage as in the copied backup files.
    • LocalTarget: use this option for backup to SAN, DAS or local storage.
    • LocalTargetHugeBackup: use this option for Veeam Agent jobs that can produce backup files larger than 16 TB.
    • LANTarget: use this option for backup to NAS and for onsite backup.
    • WANTarget: use this option if you plan to use WAN for offsite backup.

    Depending on the selected storage type, the job will use data blocks of different sizes to optimize the size of backup files.

    Default: LocalTarget.

    VBRStorageOptimizationType

    False

    Named

    False

    EnableDataDeduplication

    Defines that the cmdlet will enable the data deduplication option for backup files created with a plug-in backup copy job.

    If you do not provide this parameter, Veeam Backup & Replication will not decrease the size of these backup files.

    SwitchParameter

    False

    Named

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

    Output Object

    The cmdlet returns the VBRPluginCopyJobStorageOptions object that contains optimization settings for plug-in backup copy jobs.

    Examples

    Set-VBRPluginCopyJobStorageOptionsExample 1. Enabling Data Deduplication for Storage Optimization Settings of Plug-In Backup Copy Job

    This example shows how to enable the data deduplication option for storage optimization settings of a plug-in backup copy job.

    $options = New-VBRPluginCopyJobStorageOptions -CompressionLevel Dedupe-friendly -StorageOptimizationType LANTarget

    Set-VBRPluginCopyJobStorageOptions -Options $options -EnableDataDeduplication

    Perform the following steps:

    1. Run the New-VBRPluginCopyJobStorageOptions cmdlet. Specify the necessary parameters. Save the result to the $options variable.
    2. Run the Set-VBRPluginCopyJobStorageOptions cmdlet. Set the $options variable as the Options parameter value. Provide the EnableDataDeduplication parameter.

    Set-VBRPluginCopyJobStorageOptionsExample 2. Modifying Compression Level of Backup Files for Plug-In Backup Copy Job

    This example shows how to modify the compression level of backup files or storage optimization settings of a plug-in backup copy job. The cmdlet will change it from the dedupe-friendly to the extreme compression level.

    $options = New-VBRPluginCopyJobStorageOptions -CompressionLevel Dedupe-friendly -StorageOptimizationType LANTarget

    Set-VBRPluginCopyJobStorageOptions -Options $options -CompressionLevel Extreme

    Perform the following steps:

    1. Run the New-VBRPluginCopyJobStorageOptions cmdlet. Specify the necessary parameters. Save the result to the $options variable.
    2. Run the Set-VBRPluginCopyJobStorageOptions cmdlet. Set the $options variable as the Options parameter value. Set the CompressionLevel parameter to the Extreme value.

    Related Commands

    New-VBRPluginCopyJobStorageOptions

    I want to report a typo

    There is a misspelling right here:

     

    I want to let the Veeam Documentation Team know about that.