Introduction to Microsoft Hyper-V Automations

Download this manual as a PDF file

This section describes how to use the run book automation policies, run book actions, and custom action types found in the "Microsoft Hyper-V Automations" PowerPack. Installation of the "Windows PowerShell Automations" PowerPack is required before using the "Microsoft Hyper-V Automations" PowerPack.

Version 102 and later of the "Microsoft Hyper-V Automations" PowerPack includes updates for compatibility with Python 3. As a result, this version of the PowerPack runs only in a Python 3 execution environment.

What is the Microsoft Hyper-V Automations PowerPack?

The "Microsoft Hyper-V Automations" PowerPack includes:

  • A set of run book actions that run diagnostic commands on Hyper-V systems via PowerShell
  • A set of run book automation policies that tie events from monitoring PowerPacks to the automation actions
  • A dynamic device group for Hyper-V devices that is used to scope the automation policies

The run book actions in this PowerPack are executed on the Skylar One All-In-One Appliance or Data Collector.

In addition to using the standard content, you can use the content in the "Microsoft Hyper-V Automations" PowerPack to create your own automation policies that include the pre-defined actions that run different sets of diagnostic commands.

The "Microsoft Hyper-V Automations" PowerPack uses the supplied "Execute PowerShell Request" custom action type included with the "Windows PowerShell Automations" PowerPack.

Prerequisites

Before installing the "Microsoft Hyper-V Automations" PowerPack, you must perform the following actions:

  • Install version 202 or later of the "Datacenter Automation Utilities" PowerPack.
  • Install the "Microsoft: Hyper-V Server" PowerPack version 100 or later and configure it to monitor your Hyper-V devices.
  • Install version 105 or later of the "Windows PowerShell Automations" PowerPack .

Upgrading from a Previous Version of This PowerPack

If you are upgrading from a previous version of this PowerPack, you will need to execute the following SQL query on your Skylar One system to ensure that any run book actions on the Skylar One system from the previous versions of this PowerPack can receive updates after upgrading to this release.

To upgrade from a previous release:

  1. In Skylar One, go to the Database Tool page (System > Tools > DB Tool).

  2. Execute the following queries:

    UPDATE master.policies_actions SET action_guid ="DA83E56F17CD08430B91F64C5AAA345D" WHERE action_guid IN
("7EEE6230C4050096564969938AD9F07E")
    UPDATE master.policies_actions SET action_guid ="1C5EA01D9D944FEE3C7C2E196C5D162F" WHERE action_guid IN
("86324AFDAE1081C3A13ECEC93F6197FA");

Installing the PowerPack

Before completing the steps in this section, you must import and install the latest version of the "Microsoft Hyper-V Automations" PowerPack.

By default, installing a new version of a PowerPack overwrites all content from a previous version of that PowerPack that has already been installed on the target system. You can use the Enable Selective PowerPack Field Protection setting in the Behavior Settings page (System > Settings > Behavior) to prevent new PowerPacks from overwriting local changes for some commonly customized fields. For more information, see the section on Global Settings.

For details on upgrading Skylar One, see the relevant Skylar One Platform Release Notes.

To download and install the PowerPack:

  1. Search for and download the PowerPack from the PowerPacks page at the ScienceLogic Support Center (Skylar One > PowerPacks, login required).
  2. In Skylar One, go to the PowerPacks page (System > Manage > PowerPacks).
  3. Click the Actions button and choose Import PowerPack. The Import PowerPack dialog box appears.
  4. Click [Browse] and navigate to the PowerPack file from step 1.
  5. Select the PowerPack file and click Import. The PowerPack Installer modal displays a list of the PowerPack contents.
  6. Click Install. The PowerPack is added to the PowerPacks page.

If you exit the PowerPack Installer modal without installing the imported PowerPack, the imported PowerPack will not appear in the PowerPacks page. However, the imported PowerPack will appear in the Imported PowerPacks modal. This page appears when you click the Actions menu and select Install PowerPack.

Creating a Credential for Hyper-V Automation

The "Microsoft Hyper-V Automations" PowerPack uses the same credential that you created for the "Windows PowerShell Automations" PowerPack. Refer to the Creating a Credential section in the PowerShell Automations manual for more information.

If you have the "Microsoft: Windows Server" PowerPack installed and configured, you may skip this section.

For more information about configuring credentials in Skylar One, see Credentials.