105 lines
5.1 KiB
Markdown
105 lines
5.1 KiB
Markdown
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](https://dev.windows.com). 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](http://go.microsoft.com/fwlink/p/?linkid=301697).
|
|
|
|
Related topics
|
|
--------------
|
|
|
|
[Hyper-V WMI provider (V2)](http://msdn.microsoft.com/en-us/library/windows/desktop/hh850319)
|
|
|
|
[Virtual Storage](http://msdn.microsoft.com/en-us/library/windows/desktop/dd323653)
|
|
|
|
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.
|
|
|
|
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. 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.
|
|
|
|
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. 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.
|
|
|
|
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. The final result of the operation will be displayed in the console window.
|
|
|