Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

Foglight for Automation Action Packs 5.6.3.8 - Hyper-V ActionPack User Guide

Table of Contents

Using the ActionPack for Microsoft Hyper-V

ActionPack for Microsoft Hyper-V Requirements

PowerShell Requirements Services Requirements Local Security Settings Firewall Settings

Configuration Script

COM and Automation Objects

Workflows Actions

Apply Snapshot Attach Disk Clone VM Configure Network Adapter

Create Differencing VHD Create Dynamic VHD Create Fixed Size VHD Create Snapshot Create VM Delete VM Edit Drive

Edit VM Move VM

Pause VM Reboot Hyper-V Server Remove All Network Adapters Remove All Snapshots Remove Drive Remove Network Adapter Remove Snapshot Rename Snapshot Resume VM Revert to Snapshot Save VM Set MAC Address

Pre-conditions:

Set Network Shutdown Hyper-V Server

Input Parameters

Shutdown VM Start VM Stop VM Wait VM State

Clone VM

Clones an existing Hyper-V virtual machine. This action cannot be stopped.

The target server, which will host the cloned VM, should run a network interface that the original VM uses. For example:

•

The source server runs 2 networks: Network1 and Network2.

•

The target server runs 2 networks: Network2 and Network3.

•

VM1 and VM2 are running on the source server.

•

VM1 is connected to Network1.

•

VM2 is connected to Network2.

In such configuration you cannot create a clone of VM1 on the target server because it does not run Network1. However, you can create a clone of VM2 on the target server, because it has the Network2 interface.

Table 6. Clone VM Input Parameters
Name/Scripting name	Type	Description
Virtual machine/VirtualMachine	TopologyObject	[HPVVirtualMachine]. Virtual machine to be cloned.
Target Hyper-V server/targetServer	TopologyObject	[HPVServer]. Hyper-V server where the clone will be created.
Target folder/targetFolder	String	The folder where the clone will be stored.
Virtual Machine Name /vmName	String	The cloned virtual machine name.

Table 7. Clone VM Output Parameters
Name/Scripting name	Type	Description
Virtual machine/targetVirtualMachine	TopologyObject	[HPVVirtualMachine]. The cloned virtual machine.

Configure Network Adapter

Configures a network adapter of a Hyper-V virtual machine. This action cannot be stopped.

Pre-conditions

•

VM must be Stopped.

•

MAC address must have a valid format, for example “00155D010101” for the address “00:15:5D:01:01:01”.

Table 8. Configure Network Adapter Input Parameters
Name/Scripting name	Type	Description
Network adapter/networkAdapter	TopologyObject	[HPVNIC]. Network adapter to configure.
Network/network	TopologyObject	[HPVVirtualNetwork]. Network that will be assigned to the network adapter.
MAC address/macAddress	String	MAC Address of the network adapter.

Create Differencing VHD

Creates a differencing virtual hard disk (.VHD) file. The VHD name must not contain characters that are forbidden in Windows file names.

Table 9. Create Differencing VHD Input Parameters
Name/Scripting name	Type	Description
Hyper-V server/server	TopologyObject	[HPVServer]. Hyper-V server, which will be used for creating the VHD.
Storage Folder/storageFolder	String	The path to the folder where the VHD will be created.
VHD name/vhdName	String	Name of the new virtual hard disk.
Parent VHD/parentVhd	String	The parent VHD path.

Table 10. Create Differencing VHD Output Parameters
Name/Scripting name	Type	Description
VHD Path/vhdPath	String	The created VHD path.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating

© ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center