Executing the SL1 Agent with Windows PowerShell

Download this manual as a PDF file

Use the following menu options to navigate the SL1 user interface:

  • To view a pop-out list of menu options, click the menu icon ().
  • To view a page containing all of the menu options, click the Advanced menu icon ().

NOTE: Monitoring with the SL1 Agent is available only on SL1 Extended.

The following sections provide an overview of local Agent execution on Windows devices with PowerShell:

What is an SL1 Agent?

The SL1 agent is a program that you can install on a device monitored by SL1. There is a Windows agent, an AIX agent, a Solaris agent, and a Linux agent. The agent collects data from the device and pushes that data back to SL1.

Similar to a Data Collector or Message Collector, the agent collects data about infrastructure and applications.

You can configure an agent to communicate with either the Message Collector or the Compute Cluster.

The following minimum agent versions are required for SL1 12.1.1: Windows version 131; Linux version 174; AIX version 180; and Solaris version 180.

For more information, see the Monitoring with the SL1 Agent section.

Agent-Compatible PowerPacks

The following PowerPacks include the SL1 Agent PowerShell Default credential and SL1 Agent device template, which you can use to execute the SL1 Agent on Windows devices with PowerShell:

  • Microsoft: Windows Server
  • SL1 Agent Templates for Microsoft PowerPacks, which includes templates for the following:
  • Microsoft: DHCP Server
  • Microsoft: DNS Server
  • Microsoft: Exchange Server

    The Microsoft: Exchange Server PowerPack has two device templates. If the Exchange server monitored contains all Exchange roles, use the "SL1 Agent for Microsoft: Exchange Server Template." If your Exchange server has an Exchange Transport role, use the "SL1 Agent for Microsoft: Exchange Transport Server Template."

  • Microsoft: IIS Server
  • Microsoft: Lync Server
  • Microsoft: SharePoint Server
  • Microsoft: SQL Server
  • Microsoft: Windows Server

The Credential for the SL1 Agent

The "SL1 Agent PowerShell Default" credential does not need to be configured and can be used as-is. You can find the credential in the Credentials page (Manage > Credentials):

You can also find the credential on the Credential Management page (System > Manage > Credentials) in the SL1 classic user interface.

Configuring the SL1 Agent Device Templates

A device template allows you to save a device configuration and apply it to multiple devices. Windows PowerPacks include a device template for executing the SL1 Agent with PowerShell. If you apply this device template during discovery, SL1 aligns the appropriate Dynamic Applications to the discovered PowerShell device.

This device template does not need to be edited and will work as-is, unless you would like to remove a Dynamic Application from the template. To remove any Dynamic Applications you may not need:

  1. Go to the Configuration Templates page (Devices > Templates, or Registry > Devices > Templates in the SL1 classic user interface).
  1. Locate the SL1 Agent template (for example, "SL1 Agent for Microsoft: Windows Server Template") and click its wrench icon (). The Device Template Editor page appears.
  1. Click the Dyn Apps tab. The Editing Dynamic Application Subtemplates page appears.
  1. Modify the Template Name field, as you will not want to overwrite the sample template.
  2. To remove a Dynamic Application listed in the Subtemplate Selection section on the left side of the page, click its bomb icon (), and then click OK when asked to confirm.
  3. Click Save As.

Any time a cache-producing Dynamic Application aligned to the SL1 agent runs, all cache-consuming Dynamic Applications will run as well. The cache-consuming Dynamic Application with the shortest Polling Frequency will control when all the other cache-consuming Dynamic Applications for the same cache producer will run.