Add-SCOMAgentlessManagedComputer
Adds agentless-managed computers to a management group.
Syntax
FromAgentManagedBy
Add-SCOMAgentlessManagedComputer
[-ManagedByAgent] <AgentManagedComputer>
[-DNSHostName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromManagementServerManagedBy
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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Name |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | AgentManagedComputer |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
FromAgentManagedBy
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | ManagementServer |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
FromManagementServerManagedBy
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.