> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/hyper-v-synchronizer.md).

# Hyper-V synchronizer

Configure Hyper-V synchronizer settings in Remote Desktop Manager, including host credentials, field synchronization, and mismatch handling.

This article details the different settings and options available when configuring a Hyper-V synchronizer entry in Remote Desktop Manager.

<table data-header-hidden><thead><tr><th width="238.00006103515625"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Name</strong></td><td>Enter a name for the Hyper-V entry within Remote Desktop Manager.</td></tr><tr><td><strong>Folder</strong></td><td>Choose a folder in which to create the entry.</td></tr><tr><td><strong>Credentials</strong></td><td><p>Choose credentials to use for authentication between:</p><ul><li>Username and password</li><li>Linked</li><li>Inherited</li><li>My personal credentials</li><li>My privileged account</li><li>None</li><li>Privileged account</li></ul><p>The options offered depend on the data source.</p></td></tr><tr><td><strong>Synchronize automatically</strong></td><td>The entry will synchronize automatically with Hyper-V.</td></tr></tbody></table>

### General

<table><thead><tr><th width="183.60003662109375">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td>Enter the name or IP address of the Hyper-V host. This field is required.</td></tr><tr><td><strong>Username</strong></td><td>Enter the username for the host. This field is required, and available only when <em><strong>Credentials</strong></em> is set to <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Password</strong></td><td>Enter the password for the host. This field is required, and available only when <em><strong>Credentials</strong></em> is set to <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Version</strong></td><td><p>Choose the Hyper-V management version used to connect to the host:</p><ul><li><strong>Default</strong> — Remote Desktop Manager chooses the version, and retries with the other one if the first attempt fails.</li><li><strong>v1</strong></li><li><strong>v2</strong></li></ul></td></tr><tr><td><strong>Template</strong></td><td>Choose an existing template from the <em><strong>Template list</strong></em> or leave blank.</td></tr><tr><td><strong>Destination folder</strong></td><td>Click the ellipsis button to set the folder path in the Remote Desktop Manager tree view (which can only be in the same vault), or click the plus button to create a folder.</td></tr><tr><td><strong>Host type</strong></td><td><p>Choose which host the synchronized entries connect to:</p><ul><li><strong>Default</strong> — The host of the entry is the name of the virtual machine.</li><li><strong>Hyper-V host</strong> — The host of the entry is the Hyper-V host, and the virtual machine is identified by its instance ID.</li><li><strong>Virtual machine IP</strong> — The host of the entry is the IP address of the virtual machine. When the IP address cannot be fetched, the Hyper-V host is used instead.</li></ul><p>Forcing <em><strong>Virtual machine IP</strong></em> works only when the IP address of the machine can be fetched. Machines that are turned off or that run the Linux operating system do not provide their IP address.</p></td></tr></tbody></table>

### Fields

<table><thead><tr><th width="213.20001220703125">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Search</strong></td><td>Filter the list of fields by name.</td></tr><tr><td><strong>Field</strong></td><td><p>Select which fields will always be synchronized, and which will not:</p><ul><li><strong>Session name</strong></li><li><strong>Hostname</strong></li><li><strong>Username</strong></li><li><strong>Password</strong></li></ul><p>Select a field in the list to display its options, if it has any.</p></td></tr><tr><td><strong>Session name prefix</strong></td><td>Available when <em><strong>Session name</strong></em> is selected. A prefix for the entry that will be created through the synchronizer.</td></tr><tr><td><strong>Session name suffix</strong></td><td>Available when <em><strong>Session name</strong></em> is selected. A suffix for the entry that will be created through the synchronizer.</td></tr><tr><td><strong>Host type</strong></td><td><p>Available when <em><strong>Hostname</strong></em> is selected. Choose between:</p><ul><li><strong>Default</strong></li><li><strong>IPv4</strong></li><li><strong>IPv6</strong></li></ul></td></tr></tbody></table>

### Advanced

<table><thead><tr><th width="229.99993896484375">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Silent mode</strong></td><td>Disable error dialogs (useful when the synchronizer runs automatically at set intervals).</td></tr><tr><td><strong>Update folder only for newly discovered items</strong></td><td>Prevent the synchronizer from moving already created entries.</td></tr><tr><td><strong>Action on entry mismatch</strong></td><td><p>Choose what to do when there is a mismatch between the entries to synchronize. Here are the available options:</p><ul><li>None</li><li>Delete</li><li>Move to</li><li>Make expired</li></ul></td></tr><tr><td><strong>Destination folder</strong></td><td>Available when <em><strong>Action on entry mismatch</strong></em> is set to <em><strong>Move to</strong></em>. The folder where mismatched entries are moved.</td></tr><tr><td><strong>Expiration message</strong></td><td>Available when <em><strong>Action on entry mismatch</strong></em> is set to <em><strong>Make expired</strong></em>. The status message set on the entries that are made expired.</td></tr></tbody></table>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/hyper-v-synchronizer.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.