Windows-classic-samples/Samples/Hyper-V/IntegrationServices

Hyper-V Integration Services sample

This sample demonstrates how to use the Hyper-V Integration Services WMI APIs to interact with a virtual machine.The sample demonstrates how to perform the following operation:

• Copy file to a virtual machine CopyFilesToGuest method.

This sample is written in C# and requires some experience with WMI programming.

Note The Windows-classic-samples repo contains a variety of code samples that exercise the various programming models, platforms, features, and components available in Windows and/or Windows Server. This repo provides a Visual Studio solution (SLN) file for each sample, along with the source files, assets, resources, and metadata needed to compile and run the sample. For more info about the programming models, platforms, languages, and APIs demonstrated in these samples, check out the documentation on the Windows Dev Center. This sample is provided as-is in order to indicate or demonstrate the functionality of the programming models and feature APIs for Windows and/or Windows Server. This sample was created for Windows 8.1 and/or Windows Server 2012 R2 using Visual Studio 2013, but in many cases it will run unaltered using later versions. This sample was created for Windows 8.1 and/or Windows Server 2012 R2 using Visual Studio 2013, but in many cases it will run unaltered using later versions. Please provide feedback on this sample!

To get a copy of Visual Studio, go to Visual Studio Downloads.

Related topics

Hyper-V integration services API

Hyper-V WMI provider (V2)

Operating system requirements

Client

Windows 8.1

Server

Windows Server 2012 R2

Build the sample

1. Start Visual Studio and select File > Open > Project/Solution.

2. Go to the directory named for the sample, and double-click the Microsoft Visual Studio Solution (.sln) file titled IntegrationServices.sln.

3. Press F7 or use Build > Build Solution to build the sample.

Run the sample

Note This sample must be run as a Hyper-V administrator.

This sample can be run in the following mode.

Copy a file to a virtual machine

To run this sample in this mode, follow these steps.

1. Enter the debug command line arguments for the project. The usage of this sample is:

   IntegrationServices.exe CopyFileToGuest vmName

   where vmName is the name of the virtual machine.

2. To debug the app and then run it from Visual Studio 2013, press F5 or use Debug > Start Debugging. To run the app without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.

3. If the operation fails, an error will be displayed in the console window.