Share via

Add-SCOMAgentlessManagedComputer

  • Reference
Module:
OperationsManager

Adds agentless-managed computers to a management group.

Syntax

Add-SCOMAgentlessManagedComputer
   [-ManagedByAgent] <AgentManagedComputer>
   [-DNSHostName] <String[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-SCOMAgentlessManagedComputer
   [-ManagedByManagementServer] <ManagementServer>
   [-DNSHostName] <String[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Add-SCOMAgentlessManagedComputer cmdlet adds one or more managed computers that do not have System Center - 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.

Examples

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

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

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.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DNSHostName

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.

Type:String[]
Aliases:Name
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagedByAgent

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.

Type:AgentManagedComputer
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ManagedByManagementServer

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.

Type:ManagementServer
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False