Add-RemotelyManagedComputer
Add-RemotelyManagedComputer
Adds a remotely-managed computer to an agent.
Syntax
Parameter Set: FromAgentManagedComputer
Add-RemotelyManagedComputer [-ProxyAgent] <AgentManagedComputer> [-Computer] <CustomMonitoringObject[]> [ <CommonParameters>]
Detailed Description
Adds a remotely-managed computer to an agent.
Parameters
-Computer<CustomMonitoringObject[]>
Specifies the remote computer or computers to manage. Each value must be a CustomMonitoringObject. You can create objects of this type by using the Start-Discovery cmdlet as illustrated in the example. To enter more than one value, separate the values by using commas.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-ProxyAgent<AgentManagedComputer>
Specifies the proxy agent to use.
Aliases |
none |
Required? |
true |
Position? |
1 |
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 Add-RemotelyManagedComputer -detailed". For technical information, type "Get-Help Add-RemotelyManagedComputer -full".
When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".
Examples
-------------- EXAMPLE 1 --------------
This command first uses New-LDAPQueryDiscoveryCriteria to create an LDAP query for the computer named fabrikam in the contoso domain. It next uses New-WindowsDiscoveryConfiguration to create a windows discovery configuration based upon the LDAP query. Next, Start-Discovery is used to return discovery results about the computer fabrikam, using the management server returned by Get-ManagementServer. It then gets an agent named fabrikam2 using Get-Agent. Lastly, it uses Add-RemotelyManagedComputer to add fabrikam as a remotely-managed computer.
C:\PS>$lq = new-ldapquerydiscoverycriteria `
-domain contoso -ldapquery "(cn=fabrikam)"
$wd_cfg = new-windowsdiscoveryconfiguration `
-ldapquery $lq
$dr = start-discovery `
-managementserver (get-managementserver) `
-windowsdiscoveryconfiguration $wd_cfg
$agent = get-agent | where-object {$_.Name -eq "fabrikam2"}
add-remotelymanagedcomputer -proxyagent $agent `
-computer:$dr.custommonitoringobjects