Add-SCOMAgentlessManagedComputer

Add-SCOMAgentlessManagedComputer

Adds agentless-managed computers to a management group.

Syntax

Parameter Set: FromAgentManagedBy
Add-SCOMAgentlessManagedComputer [-DNSHostName] <String[]> [-ManagedByAgent] <AgentManagedComputer> [ <CommonParameters>]

Parameter Set: FromManagementServerManagedBy
Add-SCOMAgentlessManagedComputer [-DNSHostName] <String[]> [-ManagedByManagementServer] <ManagementServer> [ <CommonParameters>]

Detailed Description

The Add-SCOMAgentlessManagedComputer cmdlet adds one or more managed computers that do not have System Center 2012 – Operations Manager agents to a management group. Specify the ManagedByAgent parameter to have a managed agent, called a proxy agent, monitor the agentless managed computers. Specify the ManagedByManagementServer parameter to have a management server monitor the agentless-managed computers.

Parameters

-DNSHostName<String[]>

Specifies an array of names of Domain Name System (DNS) hosts. This parameter specifies the agentless-managed computers that you want to add to the management group.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-ManagedByAgent<AgentManagedComputer>

Specifies an AgentManagedComputer object. This parameter specifies the Operations Manager agent that performs agentless monitoring of the agentless-managed computers. The action account of the agent that performs the monitoring must have local administrative rights on the computer that it monitors.

To obtain an AgentManagedComputer object, use the Get-SCOMADAgent cmdlet.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-ManagedByManagementServer<ManagementServer>

Specifies a ManagementServer object. This parameter specifies the primary management server that performs agentless monitoring of the agentless-managed computers. To obtain a ManagementServer object, use the Get-SCOMManagementServer cmdlet.

Aliases

none

Required?

true

Position?

2

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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Add an agentless- managed computer to a management group-

This command specifies that the management server named MgmtServer01 performs agentless monitoring of the computer named server01. The Confirm parameter specifies that the cmdlet prompts the user to confirm the operation before the command runs.

PS C:\> Add-SCOMAgentlessManagedComputer -DNSHostName "server01.contoso.com" -ManagedByManagementServer (Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com") -Confirm

Get-SCOMAgentlessManagedComputer

Set-SCOMAgentlessManagedComputer