Move-CollectorJobs

In this article

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

    Applies to versions: 8.0, 9.0

    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.

    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(s) should be moved.

    Tip

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

     

    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.  

    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”.

    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