---
title: "Set-VMwareServerConnectionSettings"
description: "This cmdlet changes connection settings for the VMware Server (port number and access credentials)."
canonical: "https://helpcenter.veeam.com/docs/mp/veshell/set-vmwareserverconnectionsettings.html"
breadcrumb: "Veeam MP VEShell Reference > VEShell Cmdlets > Set-VMwareServerConnectionSettings"
dateModified: "2026-09-10"
---

# Set-VMwareServerConnectionSettings

Changes connection settings for the VMware server.

**Applies to versions**: 8.0, 9.0, 9a

## Syntax

```
Set-VMwareServerConnectionSettings [-Server] <String> [[-Port] <Int32>] -Credential <PSCredential> [-VESServer <Object>] [<CommonParameters>]
```

## Detailed Description

This cmdlet changes connection settings for the VMware Server (port number and access credentials).

## Parameters

### -Server \<String\>

Specifies the VMware server for which connection settings should be changed.

<table style="width:500px; head-row-background-color:#c5e2ff; alt-row-background-color:#f5f5f5;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th colspan="2" style="height:19px;">
      <p>Description</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Aliases</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Required?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>True</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Position?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>1</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Default Value</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Pipeline Input?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>True (ByValue, ByPropertyName)</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Wildcard Characters?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
</table>

### -Port \<Int32\>

Specifies the new port number for communication with the VMware server. If the parameter is not specified, the port number is not changed.

<table style="width:500px; head-row-background-color:#c5e2ff; alt-row-background-color:#f5f5f5;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th colspan="2" style="height:19px;">
      <p>Description</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Aliases</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Required?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Position?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>2</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Default Value</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Pipeline Input?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Wildcard Characters?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
</table>

### -Credential \<PSCredential\>

Specifies new user name and password for connecting to the VMware server. If the parameter is not specified, the credentials are not changed.

The input parameter is a user name (such as "Domain01\\User01").The password is entered in the interactive Windows PowerShell Credential Request prompt.

<table style="width:500px; head-row-background-color:#c5e2ff; alt-row-background-color:#f5f5f5;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th colspan="2" style="height:19px;">
      <p>Description</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Aliases</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Required?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>True</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Position?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>Named</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Default Value</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Pipeline Input?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Wildcard Characters?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
</table>

### -VESServer

Specifies the Virtualization Extensions server. You can pass the following types of values:

- Name of a machine (remote or local) where the Virtualization Extensions Service runs. 

  Acceptable formats for the input value are: server name (such as "localhost" or "."), IP address (such as "172.15.19.6") and FQDN (such as "localhost.veeam.local").

- [Veeam.Psves.VesConnection](connection.md) object.

For more information, type “[get-help about_VESServerParameter](connection_parameter.md)”.

<table style="width:500px; head-row-background-color:#c5e2ff; alt-row-background-color:#f5f5f5;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th colspan="2" style="height:19px;">
      <p>Description</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Aliases</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Required?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Position?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>Named</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Default Value</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Pipeline Input?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Wildcard Characters?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
</table>

### \<CommonParameters\>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see [Microsoft Docs](http://go.microsoft.com/fwlink/p/?LinkID=113216).

## Notes

If the `-VESServer` parameter is not specified, the cmdlet will connect to the Virtualization Extensions Service on the local machine.

## Input

The cmdlet accepts the following types of values for the `-Server` parameter:

- System.String (you can pass a VMware server name, the server name value is used exactly as it is typed)
- [Veeam.Psves.VMwareServer](vmware_server.md) (you can pass a VMware server object)

## Output

The cmdlet does not return any output.

## Example 1

This command changes connection settings for a VMware server “prod-vcenter”.

```
Set-VMwareServerConnectionSettings -Server prod-vcenter -Port 447
```

## Example 2

This example describes how to change connection settings for the VMware server “prod-vcenter”.

```
$password = "mypassword" | ConvertTo-SecureString -asPlainText –Force
$username = "domain\administrator" 
$credentials = New-Object System.Management.Automation.PSCredential($username,$password)
Set-VMwareServerConnectionSettings -Server prod-vcenter -Port 443 -Credential $credentials 
```