Export (0) Print
Expand All
Expand Minimize

Add-RemotelyManagedDevice

Add-RemotelyManagedDevice

Adds a remotely managed device to an agent.

Syntax

Parameter Set: FromAgentManagedComputer
Add-RemotelyManagedDevice [-ProxyAgent] <AgentManagedComputer> [-Device] <CustomMonitoringObject[]> [ <CommonParameters>]




Detailed Description

Adds a remotely managed device to an agent.

Parameters

-Device<CustomMonitoringObject[]>

Specifies the custom monitoring objects that are associated with the device. Use start-discovery with a device discovery configuration to retrieve discovery results that include these custom monitoring objects.


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-RemotelyManagedDevice -detailed". For technical information, type "Get-Help Add-RemotelyManagedDevice -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 requires that a variable named $dc be populated with a device discovery configuration, as demonstrated in the previous example. Start-Discovery is used to get and store discovery results in the $discovery_results variable. Get-Agent is then used to retrieve a reference to an agent named fabrikam and store it in the $agent variable. Last, Add-RemotelyManagedDevice is used to add the network device to the agent.


C:\PS>$discovery_results = start-discovery `-managementserver (get-managementserver) `-devicediscoveryconfiguration $dc$agent = get-agent | where-object {$_.Name -eq "fabrikam"}add-remotelymanageddevice -proxyagent $agent `-device $discovery_results.custommonitoringobjects

-------------- EXAMPLE 2 --------------

This command demonstrates how to create a device discovery configuration which is used in the next example. Type get-help -full new-devicediscoveryconfiguration for more information.


C:\PS>$networkdeviceclass = get-monitoringclass -name 'System.NetworkDevice'$dc = new-devicediscoveryconfiguration -monitoringclass `$networkdeviceclass -fromipaddress 192.168.0.1 -toipaddress 192.168.0.4$encoding = new-object System.Text.UnicodeEncoding$encodedCommunityString = $encoding.GetBytes("CommunityString")$dc.ReadOnlyCommunity = `[System.Convert]::ToBase64String($encodedCommunityString)

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft