Install-AgentByName

Install-AgentByName

Installs an Operations Manager agent on the specified computer.

Syntax

Parameter Set: FromMonitoringObjectProviderPath
Install-AgentByName [-Name] <String[]> [[-Path] <String[]> ] [ <CommonParameters>]

Parameter Set: FromManagementServer
Install-AgentByName [-Name] <String[]> [-ManagementServer] <ManagementServer> [ <CommonParameters>]

Detailed Description

Installs an Operations Manager agent on the specified computer.

Parameters

-ManagementServer<ManagementServer>

Specifies the management server for the agent. You can use the get-ManagementServer cmdlet to retrieve an appropriate object to provide as the value for this parameter.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Name<String[]>

The name of the machine where the Operations Manager agent is to be installed.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Path<String[]>

Specifies the paths to the management groups into which to install the specified agent. To enter more than one value, separate them by using commas.

Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Notes

  • For more information, type "Get-Help Install-AgentByName -detailed". For technical information, type "Get-Help Install-AgentByName -full".
    When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".

Examples

-------------- EXAMPLE 1 --------------

This example installs an agent on the computer named "dc.contoso.com".

C:\PS>Install-AgentByName –Name:”dc.contoso.com”

Install-Agent

Install-ManagementPack