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-SCOMAgent 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
Related topics
Get-SCOMAgentlessManagedComputer