--- title: "Set-VBRHvHost" description: "Modifies settings of Hyper-V hosts. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet modifies settings of Hyper-V hosts." canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrhvhost.html" breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Virtualization Servers and Hosts > Set-VBRHvHost" dateModified: "2026-08-19" --- # Set-VBRHvHost ## Short Description Modifies settings of Hyper-V hosts. **Product Edition**: Standard, Enterprise, Enterprise Plus, Veeam Universal License ## Syntax This cmdlet provides the following parameter sets:

Credentials (Default)
``` Set-VBRHvHost -Server [-Description ] [-Credentials ] [] ```
AddCredentials
``` Set-VBRHvHost -Server [-User ] [-Password ] [-Description ] [] ```
UseCertificate
``` Set-VBRHvHost -Server [-Description ] [-UseCertificate] [] ```

## Detailed Description This cmdlet modifies settings of Hyper-V hosts. ::: note To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged. ::: ## Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Credentials	Specifies the credentials you want to use for authenticating with the Hyper-V host. Accepts the `CCredentials` object. To get this object, run the `Get-VBRCredentials` cmdlet.	`CCredentials`	False	Named	False
Description	Specifies the description of the Hyper-V host.	`String`	False	Named	False
Password	Specifies the password you want to use for authenticating with the Hyper-V host.	`String`	False	Named	False
Server	Specifies the Hyper-V host which settings you want to modify. Accepts the `CHost` object. To create this object, run the `Get-VBRServer` cmdlet.	`CHost`	True	Named	True (ByPropertyName, ByValue)
UseCertificate	Defines that the cmdlet will use certificate-based authentication to authenticate with the Hyper-V host. This authentication method requires Veeam Deployment Kit pre-installed on the target Hyper-V host.	`SwitchParameter`	False	Named	False
User	Specifies the user name you want to use for authenticating with the Hyper-V host.	`String`	False	Named	False

`` This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7). ## Output Object The cmdlet returns the `CHost` object that contains settings of the Hyper-V hosts added to the backup infrastructure. ## Examples ::: example ### Example 1. Modifying User Name and Password of Hyper-V Host This example shows how to modify the password of the account used to add the `Hyper-V Exchange host` Hyper-V cluster to the backup infrastructure. ``` $server = Get-VBRServer Set-VBRHvHost Server $server -Password "XXXXXXXXXX" ``` Perform the following steps: 1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Save the result to the `$server` variable. 2. Run the `Set-VBRHvHost` cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Password` parameter value. ::: ::: example ### Example 2. Modifying Credentials of Hyper-V Host This example shows how to modify credentials of the `HyperVExchange` Hyper-V cluster. ``` $Administrator = Get-VBRCredentials $server = Get-VBRServer Set-VBRHvHost -Server $server -Credentials $Administrator ``` Perform the following steps: 1. Run the [`Get-VBRCredentials`](get-vbrcredentials.md) cmdlet. Save the result to the `$Administrator` variable. 2. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Save the result to the `$server` variable. 3. Run the `Set-VBRHvHost` cmdlet. Set the `$server` variable as the `Server` parameter value. Set the `$Administrator` variable as the `Credentials` parameter value. ::: ::: example ### Example 3. Modifying Authentication Method of Hyper-V Host to Certificate-Based Authentication This example shows how to switch the authentication method of the `HyperVExchange` Hyper-V cluster to certificate-based authentication. ``` $server = Get-VBRServer Set-VBRHvHost -Server $server -UseCertificate ``` Perform the following steps: 1. Install Veeam Deployment Kit on the Hyper-V host you want to modify. 2. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Save the result to the `$server` variable. 3. Run the `Set-VBRHvHost` cmdlet. Set the `$server` variable as the `Server` parameter value. Provide the `UseCertificate` parameter. ::: ## Related Commands - [`Get-VBRCredentials`](get-vbrcredentials.md) - [`Get-VBRServer`](get-vbrserver.md)