Set-VBRJobObjectVssOptions

Short Description

Customizes job VSS settings.

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides the following parameter sets:

Manual (Default)

Set-VBRJobObjectVssOptions [-Object] <CObjectInJob> [-Options] <CGuestProcessingOptions> [<CommonParameters>]
Credentials

Set-VBRJobObjectVssOptions [-Object] <CObjectInJob> -Credentials <CCredentials> [<CommonParameters>]

Detailed Description

This cmdlet applies a set of customized VSS settings to the specific objects in job or sets credentials to authenticate with the specific objects in job.

To apply the set of customized settings you need to first create a CVssOptions object. This object unifies all the VSS options you want to apply to the job object.

Run the New-VBRJobVssOptions cmdlet to create the CVssOptions object.

Run the Set-VBRJobVssOptions cmdlet to set the VSS options to the whole job.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Credentials	Specifies the credentials you want to use for authenticating with the guest VM. Accepts the `CCredentials` object. To get this object, run the `Get-VBRCredentials` cmdlet.	`CCredentials`	True	Named	False
Object	Specifies the VMs and VM containers for which you want to change VSS settings. Accepts the `CObjectInJob` object. To get this object, run the `Get-VBRJobObject` cmdlet.	`CObjectInJob`	True	0	True (ByPropertyName, ByValue)
Options	Specifies the option that you want to change. Accepts the `CVssOptions` object. To get this object, run the `New-VBRJobVssOptions` cmdlet.	`CGuestProcessingOptions`	True	1	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Examples

Set-VBRJobObjectVssOptions Example 1. Applying Custom VSS Options to Specific VM [Using Pipeline]

This example shows how to apply custom VSS options to the AD_01 VM included in the backup job named Active Directory Backup.

$options = New-VBRJobVssOptions -ForObject

Get-VBRJob -Name "Active Directory Backup" | Get-VBRJobObject -Name "AD_01" | Set-VBRJobObjectVssOptions -Options $options

Perform the following steps:

Run the New-VBRJobVssOptions cmdlet. Provide the ForObject parameter. Save the result to the $options variable.
Run the Get-VBRJob cmdlet. Specify the Name parameter value.
Pipe the cmdlet output to the Get-VBRJobObject cmdlet. Specify the Name parameter value.
Pipe the cmdlet output to the Set-VBRJobObjectVssOptions cmdlet. Set the $options variable as the Options parameter value.

Set-VBRJobObjectVssOptions Example 2. Applying Custom VSS Options to VM Running Active Directory [Using Variable]

This example shows how to apply custom VSS options to the VMs running Active Directory represented by the $AD_VMs variable.

$AD_VMs = Get-VBRJobObject

$options = New-VBRJobVssOptions -ForObject

Set-VBRJobObjectVssOptions -Object $AD_VMs -Options $options

Perform the following steps:

Run the Get-VBRJobObject cmdlet. Save the result to the $AD_VMs variable.
Run the New-VBRJobVssOptions cmdlet. Provide the ForObject parameter. Save the result to the $options variable.
Run the Set-VBRJobObjectVssOptions cmdlet. Set the $AD_VMs variable as the Object parameter value. Set the $options variable as the Options parameter value.

Set-VBRJobObjectVssOptions Example 3. Setting Credentials to Authenticate with SQL Server Included in Specific Backup Job [Using Pipeline]

This example shows how to set credentials to authenticate with the SQL server included in the SharePoint backup job.

$SharePointBackup = Get-VBRJob

$Administrator = Get-VBRCredentials

Get-VBRJobObject -Job $SharePointBackup -Name "SharePoint_SQL" | Set-VBRJobObjectVssOptions -Credentials $Administrator

Perform the following steps:

Run the Get-VBRJob cmdlet. Specify the Name parameter value. Save the result to the $SharePointBackup variable.
Run the Get-VBRCredentials cmdlet. Save the result to the $Administrator variable.
Run the Get-VBRJobObject cmdlet. Set the $SharePointBackup variable as the Job parameter value. Specify the Name parameter value.
Pipe the cmdlet output to the Set-VBRJobObjectVssOptions cmdlet. Set the $Administrator variable as the Credentials parameter value.

Set-VBRJobObjectVssOptions Example 4. Setting Credentials to Authenticate with VM [Using Variable]

This example shows how to set credentials to authenticate with the VM represented by the $SharePoint_SQL variable.

$SharePoint_SQL = Get-VBRJobObject

$Administrator = Get-VBRCredentials

Set-VBRJobObjectVssOptions -Object $SharePoint_SQL -Credentials $Administrator

Perform the following steps:

Run the Get-VBRJobObject cmdlet. Save the result to the $SharePoint_SQL variable.
Run the Get-VBRCredentials cmdlet. Save the result to the $Administrator variable.
Run the Set-VBRJobObjectVssOptions cmdlet. Set the $SharePoint_SQL variable as the Object parameter value. Set the $Administrator variable as the Credentials parameter value.