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

Move-CollectorJobs

Moves one or more monitoring jobs from one Collector to another.

Applies to versions: 8.0, 9.0, 9a

Syntax

Move-CollectorJobs [-Jobs] <MonitoringJob[]> [-Collector] <String> [-Force] [-VESServer <Object>] [<CommonParameters>]

Detailed Description

This cmdlet moves one or more monitoring jobs from one Collector to another.

Note

You cannot break monitoring jobs for a split cluster across different monitoring groups. Monitoring jobs associated with a single vSphere cluster can only belong to the same monitoring group. If you want to assign cluster jobs to a Collector in another monitoring group, you should move all cluster jobs at once.

Parameters

-Jobs <MonitoringJob[]>

Specifies monitoring jobs that should be moved.

-Jobs <MonitoringJob[]>

Description

Aliases

Required?

True

Position?

1

Default Value

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

False

-Collector <String>

Specifies Id of the Collector to which the job should be moved.

Tip

To get the list of registered Collectors, their Ids and names, use the Get-Collector cmdlet.

-Collector <String>

Description

Aliases

Required?

True

Position?

2

Default Value

Accept Pipeline Input?

False

Accept Wildcard Characters?

True

-Force

Specifies whether the confirmation dialog should be suppressed. If the parameter is not specified, the cmdlet will prompt you to confirm the job movement.  

-Force

Description

Aliases

Required?

False

Position?

Named

Default Value

Accept Pipeline Input?

False

Accept Wildcard Characters?

False

-VESServer

Specifies the Virtualization Extensions server. You can pass the following types of values:

  • Name of a machine (remote or local) where the Virtualization Extensions Service runs.

Acceptable formats for the input value are: server name (such as "localhost" or "."), IP address (such as "172.15.19.6") and FQDN (such as "localhost.veeam.local").

For more information, type “get-help about_VESServerParameter”.

-VESServer

Description

Aliases

Required?

False

Position?

Named

Default Value

Accept Pipeline Input?

False

Accept Wildcard Characters?

False

<CommonParameters>

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

Notes

If the -VESServer parameter is not specified, the cmdlet will connect to the Virtualization Extensions Service on the local machine.

Input

The cmdlet accepts the following types of values for the -Jobs parameter:

Output

The cmdlet does not return any output.

Example

This example describes how to move all monitoring jobs from Collector “veeamcol2”  to Collector ”veeamcol1”.

$veeamcol1 = Get-Collector veeamcol1 -SelectByName

Get-Collector veeamcol2 -SelectByName | Get-CollectorJobs | Move-CollectorJobs -Collector $veeamcol1