This is an archive version of the document. To get the most up-to-date information, see the current version.

New-VBRJobVssOptions

Short Description

Returns default set of VSS options for job or VM in job.

Applies to

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides the following parameter sets.

Default VSS settings for backup jobs (including vCloud backup jobs):

New-VBRJobVssOptions [-ForJob] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Default VSS settings for VMs in job:

New-VBRJobVssOptions [-ForObject] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Default VSS settings for replication jobs:

New-VBRJobVssOptions [-ForReplicaJob] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Detailed Description

This cmdlet returns the CVssOptions object containing default VSS settings for backup jobs, replication jobs or selected VMs. Use an appropriate parameter set for each case.

You can modify the settings and use this object to change the VSS settings of a job or VM. Run Set-VBRJobVssOptions to apply the VSS settings to a job.

New-VBRJobVssOptions Tip:

Save the object to a variable when you customize settings: this variable can be used in several jobs.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
ForJob	Returns the list of the default VSS settings for backup, replication or copy job.	False	Named	False	False
ForObject	Returns the list of the default VSS settings for VMs.	False	Named	False	False
ForReplicaJob	Returns the list of the default VSS settings for replication job.	False	Named	False	False

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

Example

This example enables the VSS settings and the Copy only option.

Get the default settings:

New-VBRJobVssOptions -ForJob

VssSnapshotOptions : Enabled: [False], IgnoreErrors: [True], IsCopyOnly: [False]

WinGuestFSIndexingOptions : Type: [None]

LinGuestFSIndexingOptions : Type: [None]

SqlBackupOptions : TransactionLogsProcessing: [TruncateOnlyOnSuccessJob], BackupLogsFrequencyMin: [15],

UseDbBackupRetention: [True], RetainDays: [15], ProxyAutoSelect: [True]

GuestScriptsOptions : Veeam.Backup.Model.CGuestScriptsOptions

ExchangeBackupOptions : TransactionLogsProcessing: [TruncateOnlyOnSuccessJob]

WinCredsId : 00000000-0000-0000-0000-000000000000

LinCredsId : 00000000-0000-0000-0000-000000000000

Enabled : False

IgnoreErrors : True

AreWinCredsSet : False

AreLinCredsSet : False

GuestFSIndexingType : None

IncludedIndexingFolders : {}

ExcludedIndexingFolders : {}

LinGuestFSIndexingType : None

LinIncludedIndexingFolders : {}

LinExcludedIndexingFolders : {}

IsFirstUsage : True

m_isFirstUsage : True

Modify the VSS settings.

The output is saved to '$o' variable.

The Enabled setting is set to True.
The VssSnapshotOptions for IsCopyOnly is set to True.

$o = New-VBRJobVssOptions

$o.Enabled = $true

PS C:\Users\Administrator> $o.VssSnapshotOptions.IsCopyOnly = $true

PS C:\Users\Administrator> $o

VssSnapshotOptions : Enabled: [False], IgnoreErrors: [True], IsCopyOnly: [True]