Veeam Management Pack 9.0 for Microsoft System Center
Veeam MP VEShell Reference
Related documents

Invoke-LoadBalance

Forces monitoring load balancing across available Collectors.

Applies to versions: 8.0, 9.0

Syntax

Invoke-LoadBalance [-MonitoringGroup] <String[]> [-Force] [-WhatIf] [-Confirm] [-VESServer <Object>] [<CommonParameters>]

Detailed Description

This cmdlet forces monitoring load balancing across available Collectors for the specified monitoring group(s).

Load-balancing relocates monitoring jobs across all available Collectors within the monitoring group to equalize the monitoring load on each Collector. Jobs are balanced only within the group.

Note

Load-balancing can entail a monitoring outage of several collection intervals (for those monitoring jobs which have moved) while the VMware topology rebuilds.

Parameters

-MonitoringGroup <String[]>

Specifies the list of monitoring groups for which load-balancing should be performed.

Description

Aliases

 

Required?

True

Position?

1

Default Value

 

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

False

-Force

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

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 -MonitoringGroup parameter:

  • System.String (you can pass monitoring group names, the name value is used exactly as it is typed)
  • Veeam.Psves.MonitoringGroup (you can pass monitoring group objects)

Output

The cmdlet does not return any output.

Example 1

This command reallocates monitoring jobs within the Default Monitoring Group.

Invoke-LoadBalance -MonitoringGroup “Default Monitoring Group”

-OR-

Invoke-LoadBalance “Default Monitoring Group”

Example 2

This command reallocates monitoring jobs within the “mongroup1” and “mongroup2”.

Invoke-LoadBalance mongroup1, mongroup2

Example 3

This command balances monitoring load for all monitoring groups.

Get-MonitoringGroup | Invoke-LoadBalance

This Document Help Center
Veeam MP for VMware User GuidesVeeam MP for VMware ReferenceVeeam MP for VMware Online Knowledge BaseVeeam MP for Microsoft Hyper-V User GuideVeeam MP for Hyper-V ReferenceMP for Veeam Backup & Replication User GuideMP for Veeam Backup & Replication ReferenceVeeam Capacity Planning for Hybrid Clouds User GuideVeeam MP Report KnowledgeVeeam MP VEShell ReferenceVeeam MP Resource Kit GuideVeeam Backup & Replication DocumentationVeeam Agent for Windows DocumentationVeeam Agent for Linux Documentation
I want to report a typo

There is a misspelling right here:

 

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