Windows/Windows-classic-samples
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Windows-classic-samples/Samples/Hyper-V/StorageQoS/README.md
Raten 12d6772ad2 new
2025-11-28 00:35:46 +09:00

5.1 KiB
Raw Blame History

Hyper-V storage QoS sample

This sample demonstrates how to use the Hyper-V WMI storage APIs to configure and monitor Quality of Service for virtual disks.The sample demonstrates how to perform each of the following operations:

  • Read current Quality of Service settings for a virtual disk.
  • Modify Quality of Service settings for a virtual disk.
  • Monitor whether the Quality of Service requirements for a virtual disk are being satisfied.

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 WMI provider (V2)

Virtual Storage

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 StorageQoS.sln.

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

Run the sample

Note This sample must be run as an administrator.

This sample can be run in several different modes. To obtain a list of the operations, use the following command line:

StorageQoSSamples.exe /?

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.

Read Quality of Service settings for a virtual disk

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:

StorageQoSSamples.exe get Host VirtualMachineName VhdPath

Where the parameters are as follows:

  • Host specifies the name of the Hyper-V server to connect to.
  • VirtualMachineName specifies the name of the virtual machine.
  • VhdPath specifies the full path of the VHD to query.

  1. 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.

  2. The final result of the operation will be displayed in the console window.

Modify Quality of Service settings for a virtual disk

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:

StorageQoSSamples.exe set Host VirtualMachineName VhdPath (-max | -min) IOPS

Where the parameters are as follows:

  • Host specifies the name of the Hyper-V server to connect to.
  • VirtualMachineName specifies the name of the virtual machine.
  • VhdPath specifies the full path of the VHD to modify
  • IOPS specifies the maximum throughput (if the -max switch is specified) or the minimum throughput (if the -min switch is specified) for the virtual disk.

  1. 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.

  2. The final result of the operation will be displayed in the console window.

Monitor whether Quality of Service requirements are being satisfied

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:

StorageQoSSamples.exe monitor Host

where Host is the name of the Hyper-V server to connect to and monitor.

  1. 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.

  2. The final result of the operation will be displayed in the console window.