Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 19 Next »

 



Connect To HyperV

This activity connects to a Hyper-V Host. The Output of this activity should be used as Input for all Connection parameters used for all activities found under this category.

Activity Parameters

The Connect to HyperV activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Authority (text box editor type) (type: string): leave the default value for this parameter or blank if no authority is required.
  • Hostname or IP (text box editor type) (type: string): the Hostname or IP address of target machine - example: "\\\\10.10.10.10\\root\\virtualization" or "\\\\ServerName\\root\\virtualization".
  • Password (text box editor type) (type: string): the password for the provided username.
  • Password Binding (text box editor type) (type: string): bind to a variable containing the encrypted password for the HyperV. (This parameter is used only when the user wants to send an encripted password from outside the task, for example Flowster Portal).
  • Username (text box editor type) (type: string): the username for the user to query to the remote computer.

The Read Only Output variable are the possible output values that the activity will provide:

  • Connection  (type: object): outputs a Hyper-V connection. The Output parameter should be used as Input for all Connection parameters of the activities found under HyperV category.
 

 

 

 

Disconnect from HyperV

This activity disconnects from a Hyper-V Host.

Activity Parameters

The Disconnect from HyperV activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Connection (text box editor type) (type: object): the Hyper-V Host connection. The Output from Connect to Hyper-V activity should be used as Input here.

Add Virtual Hard Drive

This activity creates a virtual hard drive for the specified VM.

Activity Parameters

The Add Virtual Hard Drive activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Address (text box editor type) (type: string): the MAC address.
  • Network Adapter Name (text box editor type) (type: string): the name of the network adapter.
  • VHD Name (text box editor type) (type: string): the name of the virtual hard drive.
  • VM Name (text box editor type) (type: string): the name of the VM to be created.

The Read Only Output variable are the possible output values that the activity will provide:

  • Created  (type: boolean): outputs a bool value indicating if the VM was successfully created.
 

 

 

Add Virtual Network

This activity creates a virtual network for the specified VM.

Activity Parameters

The Add Virtual Network activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Address (text box editor type) (type: string): the MAC address.
  • Network Adapter Name (text box editor type) (type: string): the name of the network adapter.
  • VM Name (text box editor type) (type: string): the name of the VM to be created.

The Read Only Output variable are the possible output values that the activity will provide:

  • Created  (type: boolean): outputs a bool value indicating if the VM was successfully created.
 

 

 

Clone VM

This activity clones a VM on a HyperV host.

Activity Parameters

The Clone VM activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Base Machine Name (text box editor type) (type: string): the name of the base virtual machine name.
  • Machine Folder (text box editor type) (type: string): the full path where the virtual machine will be created.
  • VM Name (text box editor type) (type: string): the name of the VM to be created.

The Read Only Output variable are the possible output values that the activity will provide:

  • Created  (type: boolean): outputs a bool value indicating if the VM was successfully created.
 

 

 

Compact Virtual Hard Disk

This activity compacts a dynamic virtual hard disk file. Compacting is the process of unallocating unused portions of the virtual hard disk.

Activity Parameters

The Compact Virtual Hard Disk activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Path (text box editor type) (type: string): the fully qualified path that specifies the location of the merging file.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Status  (type: boolean): outputs a bool value indicating if the compacting was successfully done.
 

 



 

Create New Disk

This activity creates a new disk and add it to a virtual machine.

Activity Parameters

The Create New Disk activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Base Image Path (text box editor type) (type: string): the full path of base virtual disk image to use.
  • Disk Type (combo box control) (type: string): the virtual disk type.
  • New Image Path (text box editor type) (type: string): the full path (with disk image name) of new virtual disk image.
  • Size (text box editor type) (type: int32): the size of the new virtual disk in GB.

The Read Only Output variable are the possible output values that the activity will provide:

  • Created  (type: boolean): outputs a bool value indicating if the virtual hard disk was successfully created.
 

 

Create User Role

This activity creates a user role on a HyperV virtual machine.

Activity Parameters

The Create User Role activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • Scope Name (text box editor type) (type: string): the authorization scope to use in determining the access control policy for the virtual machine.
  • VM Name (text box editor type) (type: string): the name of the VM.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Created  (type: boolean): outputs a bool value indicating if the user role was successfully created.

 



 

Create VM

This activity creates a VM on a HyperV host.

Activity Parameters

The Create VM activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of the VM to be created.

The Read Only Output variable are the possible output values that the activity will provide:

  • Created  (type: boolean): outputs a bool value indicating if the vm was successfully created.
 



 

Create VM From Template

This activity creates a VM on a HyperV host.

Activity Parameters

The Create VM from Template activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Source Template Name (text box editor type) (type: string): the name of the virtual machine Template used to create the virtual machine.
  • VM Name (text box editor type) (type: string): the name of the VM to be created.

The Read Only Output variable are the possible output values that the activity will provide:

  • Created  (type: boolean): outputs a bool value indicating if the vm was successfully created.
 

 

 

Delete Snapshot

This activity removes the specified snapshot of the specified VM.

Activity Parameters

The Delete Snapshot activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Snapshot Name (text box editor type) (type: string): the snapshot name.
  • VM Name(text box editor type) (type: string): the name of virtual machine.
 

 

Delete User Role

This activity deletes a user role on a HyperV virtual machine.

Activity Parameters

The Delete User Role activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of the VM.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Status  (type: boolean): outputs a bool value indicating if the user role was successfully deleted.
 

 

 

Delete VM

This activity removes the specified virtual machine.

Activity Parameters

The Delete VM activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine.
 

 

Expand Virtual Hard Disk

This activity expands an existing virtual hard disk (.vhd) file.

Activity Parameters

The Expand Virtual Hard Disk activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Max Internal Size (text box editor type) (type: int32): the maximum size of the virtual hard disk as viewable by the virtual machine, in bytes. MaxInternalSize minimum value is DiskSize + 512 - (DiskSize mod 512). DiskSize is the disk image file in number of bytes. The InvalidParameter error (32773) is returned if the MaxInternalSize value specified is less than the minimum value.
  • Path (text box editor type) (type: string): the fully qualified path that specifies the location of the disk image file.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Status  (type: boolean): outputs a bool value indicating if the expanding was successfully done.
 

 

 

 

Get User Role

This activity gets the user role of a HyperV virtual machine.

Activity Parameters

The Get User Role activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of the VM.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Scope  (type: string): outputs the 'ScopeOfResidence' value.
  

 

Get VM Host

This activity gets the host of a HyperV virtual machine.

Activity Parameters

The Get VM Host activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of the VM.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Host  (type: string): outputs the host name.
 

 

 

Get VMs on HyperV

This activity gets and returns all registered Virtual Machines on a Hyper-V Host.

Activity Parameters

The Get VMs on HyperV activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Connection (text box editor type) (type: string): the Hyper-V Host connection. The Output from Connect to Hyper-V activity should be used as Input here.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output  (type: collection<string>): outputs a collection of all VMs from a HyperV host.To use the elements of the collection, use Get Element From Collection activity.

 

 

HyperV Apply Snapshot

This activity applies the specified snapshot to the specified VM.

Activity Parameters

The HyperV Apply Snapshot activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Apply Latest (combo box control) (type: string): if set to yes, it will apply the last snapshot created.
  • Snapshot Name (text box editor type) (type: string): if Apply Latest set to no, this snapshot will be applied, otherwise this parameter is ignored.
  • VM Name (text box editor type) (type: string): the name of virtual machine.

 



 

HyperV Edit VM Parameters

This activity modify a specified VM's parameters.

Activity Parameters

The HyperV Edit VM Parameters activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • New VM Name (text box editor type) (type: string): the new name for the VM, if you do not wish to edit it, leave empty.
  • VM Name (text box editor type) (type: string): the name of the VM to be edited.

 



 

HyperV Export VM

This activity exports a virtual computer system, or a snapshot of a virtual computer system, in the 'powered off' or 'saved' state to a file.

Activity Parameters

The HyperV Export VM activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Folder (text box editor type) (type: string): the folder path from the HyperV host machine to which to save the exported VM.
  • VM Name (text box editor type) (type: string): the name of virtual machine to export.
 



 

HyperV Import VM

This activity imports a virtual computer system. The resulting virtual computer system will be in the Disabled state.

Activity Parameters

The HyperV Import VM activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Import Directory (text box editor type) (type: string): the folder from which to import the VM (path relative to the HyperV Host machine).
  • Import VM Name (text box editor type) (type: string): the name for the imported VM.
  • Root Directory (text box editor type) (type: string): the folder to which to store the imported VM.
  • Target Connection (text box editor type) (type: string): the Hyper-V Host connection to which the specified VM will be imported. The Output from Connect to Hyper-V activity should be used as Input here.
 

 

 

List VM Snapshots

This activity retrieves all snapshots belonging to a specified VM.

Activity Parameters

The List VM Snapshots activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine.

 

The Read Only Output variable are the possible output values that the activity will provide:

  • Snapshot List  (type: collection<ManagementObject>): output of type System.Management.ManagementObjectCollection(collection of ManagementObject).
  • Snapshot Names List  (type: collection<string>): output of type Collection. Represents the names of the snapshots contained in Snapshot List.
 

 

 

  

Merge Virtual Hard Disk

This activity merges a differencing virtual hard disk file with its parents. If the user executing this function does not have permission to update the virtual machines, then this function will fail.

Activity Parameters

The Merge Virtual Hard Disk activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Destination Path (text box editor type) (type: string): the fully qualified path that specifies the location of the parent disk image file into which data is to be merged. This could be the immediate parent virtual disk image of the merging file or parent disk image few levels up the differencing drive chain.
  • Source Path (text box editor type) (type: string): the fully qualified path that specifies the location of the merging file.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Status  (type: boolean): outputs a bool value indicating if the merge was successfully done.
 

 

 

 

Mount Virtual Disk

This activity mounts a virtual disk image file.

Activity Parameters

The Mount Virtual Disk activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Path (text box editor type) (type: string): the fully qualified path that specifies the location of the disk image file.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output  (type: boolean): outputs 'true' if the specified virtual disk was mounted, otherwise 'false'.
 

 

 

 

Pause VM on HyperV

This activity pauses a specified virtual machine on a Hyper-V Host.

Activity Parameters

The Pause VM on HyperV activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine to Pause.

 

 

 

Power Off VM on HyperV

This activity powers off a specified virtual machine on a Hyper-V Host.

Activity Parameters

The Power Off VM on HyperV activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine to power off.
 

 

 

Power On VM on HyperV

This activity powers on a specified virtual machine on a Hyper-V Host.

Activity Parameters

The Power On VM on HyperV activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine to power on.
 

 

 

Reboot VM on HyperV

This activity reboots the guest operating system of a specified virtual machine on a Hyper-V Host.

Activity Parameters

The Reboot VM on HyperV activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine to reboot.
 

 

 

 

Remove Network Adapter

This activity removes the specified Network Adapter of the specified VM.

Activity Parameters

The Remove Network Adapter activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Network Adapter Name (text box editor type) (type: string): the Network Adapter name.
  • VM Name (text box editor type) (type: string): the name of virtual machine.

 

 

 

Reset VM on HyperV

This activity resets a virtual machine on a Hyper-V Host.

Activity Parameters

The Reset VM on HyperV activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine to reset.
 

 

 

 

Save Snapshot

This activity saves the current state of a specified virtual machine.

Activity Parameters

The Save Snapshot activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine.
 

 

 

 

Shutdown VM on HyperV

This activity shuts down the guest operating system of a specified virtual machine on an Hyper-V Host.

Activity Parameters

The Shutdown VM on HyperV activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Vm Name (text box editor type) (type: string): the name of virtual machine.
 

 

 

 

Unmount Virtual Disk

This activity unmounts a virtual disk image file.

Activity Parameters

The Unmount Virtual Disk activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Path (text box editor type) (type: string): the fully qualified path that specifies the location of the disk image file.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output  (type: boolean): outputs 'true' if the specified virtual disk was deleted, otherwise 'false'.

 

 

 

VM Exists

This activity verifies if the specified virtual machine exists.

Activity Parameters

The VM Exists activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Vm Name (text box editor type) (type: string): the name of virtual machine.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output  (type: boolean): outputs 'true' if the specified VM exists, otherwise 'false'.
 

 

VM Get Network Adapter

This activity retrieves an existing Virtual Network Adapter based on the filters you specify.

Activity Parameters

The VM Get Network Adapter activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine.

 

The Read Only Output variable are the possible output values that the activity will provide:

  • Output  (type: collection<collection<string>>): outputs the address of the resource. For example, the MAC address of a Ethernet port.
  • Output MAC Address  (type: string): outputs the address of the resource. For example, the MAC address of a Ethernet port.
 

 



 

 

VM Get Status

This activity retrieves the state and other related information about a virtual machine.

Activity Parameters

The VM Get Status activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • VM Name (text box editor type) (type: string): the name of virtual machine.

 

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Status  (type: collection<collection<string>>): outputs the current status of the virtual machine.
 

 



 

 

VM Get Virtual Hard Disk

This activity retrieves information about a virtual hard disk.

Activity Parameters

The VM Get Virtual Hard Disk activity parameters can be provided by manual inserted values or via IN arguments or variables:

 

Parameters:

  • Path (text box editor type) (type: string): the fully qualified path that specifies the location of the disk image file.

 

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Details  (type: collection<string>): outputs all the information about the virtual hard disk.
 

 

  • No labels