Running a Windows Task

From OpsWise Documentation Wiki

Open as PDF

To do this exercise, you first need a running Windows agent.

Contents 1 Viewing Information about the Agent 2 Creating a Simple Windows Task 3 Retrieving Output from a Windows Task 4 Attaching Output to an Email Notification

Viewing Information about the Agent

When you install and start an agent, information about the agent is automatically registered and added to the OpsWise Automation Center database. To view the information:

1. From the navigation pane, select Resources > All Agents. Depending on what agents are running, you will see a list similar to the following:



2. Note that the Status column indicates whether this agent is running and accessible. Click on the Agent Name for your Windows agent. Details for the agent display, as shown in this example.



3. Most of the information is protected. See Agent-Based Resources for information about which fields you can change.

Creating a Simple Windows Task

1. Select Tasks > Windows Tasks and click New.
2. In Task Name, type Making Dir "Tutorial".
3. In the Agent field, select your Windows agent.
4. In the Command field, type:

md c:\tutorial

5. Click Submit.
6. From the Agent list, right-click on Making Dir "Tutorial" and select Launch Task.
7. Check the Activity screen for the task instance.

Retrieving Output from a Windows Task

In this Windows task, we will run a DIR command. After running it, we will retrieve and display the resulting output.

1. Use the same steps to create another Windows task called Dir with Output. Use the following command:

dir c:\windows

2. Save and launch the task.
3. View the task on the Activity screen, and click on the name.
4. Note that the Output tab is empty. Click Retrieve Output. The Retrieve Output window appears:



5. Change the number of lines to 300 and click Submit.
6. Click the Output tab. The STDOUT (standard output) displays on the output list, as shown in the following example:


You can also click the STDOUT to view the record.

Attaching Output to an Email Notification

In this exercise, we will modify our DIR Windows task with an Email notification that includes the output from our DIR command.

1. Open the Dir with Output task you just created.
2. Click the Actions tab and click New.
3. Select Email Notification.
4. Specify the following:
   • Status=Success
   • Email Connection=Your email connection
   • To=Your email address
   • Subject=Output
   • Body=See attached.
   • Attach Standard Output=enabled
   • Start Line=1
   • Number of lines=300
5. Click Submit.
6. Launch the task.
7. Once the Windows task goes to success, check your inbox for the email. The output is attached, as shown in the following example.