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

Add-RemotelyManagedDevice

Get-RemotelyManagedComputer

Get-RemotelyManagedDevice

Remove-RemotelyManagedComputer

Remove-RemotelyManagedDevice

Start-Discovery