> For the complete documentation index, see [llms.txt](https://www.osdcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.osdcloud.com/osdcloud-v1/osdcloud/setup/osdcloud-vm.md).

# OSDCloud VM

{% hint style="warning" %}
**This page is under construction and the update hasn't even been released, so there is nothing you can do yet.  Be patient**
{% endhint %}

Let's have an intimate conversation about Hyper-V and OSDCloud.  For starters, I do almost all of my testing in Hyper-V on my Workstation, and I've been creating Virtual Machines hundreds of times ... all of that wasted time.  So how about automating this process for OSDCloud

## Admin Rights

Let's start with the obvious, you will need Admin Rights.  You won't even see the **`New-OSDCloudVM`** function without it.  Got it?

<figure><img src="/files/bb8H6G0zBRqTz2xsfmhW" alt=""><figcaption></figcaption></figure>

## Hyper-V

Get your Hyper-V in working order.  This is a new function, and I don't have all the checks in place so expect things to go sour if you haven't at least created a Virtual Machine

## Workspace

Your OSDCloud Workspace should be in good order as well.  You can easily check this with **`Get-OSDCloudWorkspace`**.  What is important to know is that OSDCloud VM uses the OSDCloud\_NoPrompt.iso to boot.

If you need to change your OSDCloud Workspace, use the **`Set-OSDCloudWorkspace`** function

<figure><img src="/files/btYw4LK8B8bItE0OhVN6" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.osdcloud.com/osdcloud-v1/osdcloud/setup/osdcloud-vm.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
