---
title: "New-VBRIndividualComputerCustomCredentials"
description: "Specifies a method for authenticating individual computers. Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet specifies a method for authenticatin"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrindividualcomputercustomcredentials.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Protection Groups > Veeam Agent Management Protection Scope > New-VBRIndividualComputerCustomCredentials"
dateModified: "2026-08-19"
---

# New-VBRIndividualComputerCustomCredentials

## Short Description
Specifies a method for authenticating individual computers.

**Product Edition**: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Credentials</code></p>

```
New-VBRIndividualComputerCustomCredentials -HostName <String> -Credentials <CCredentials> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>TempCertificates</code></p>

```
New-VBRIndividualComputerCustomCredentials -HostName <String> [-UseTemporaryCertificate] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>TempCredentials</code></p>

```
New-VBRIndividualComputerCustomCredentials -HostName <String> [-SSHTempCredentials] -SSHUser <String>
 -SSHPassword <String> [-SSHPort <UInt16>] [-SSHElevateToRoot] [-SSHFailoverToSu] [-SSHRootPassword <String>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet specifies a method for authenticating individual computers that you want to add to a protection group. Veeam Backup & Replication uses this method for Veeam Agent deployment and backup\\restore activities.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Credentials</span></p>
        </td>
        <td>
          <p>Specifies a method to authenticate against individual computers in a protection group.</p><p><strong>Note</strong>: for string type, enter a user name in the <code>DNS.DOMAIN.NAME\USERNAME</code> or <code>USERNAME@DNS.DOMAIN.NAME</code> format.</p><p>Accepts string (user name) or the <code>CCredentials</code> object. To get this object, run the <a href="get-vbrcredentials.md"><code>Get-VBRCredentials</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">HostName</span></p>
        </td>
        <td>
          <p>Specifies the DNS name or an IP address of the computer for which you want to specify custom credentials.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SSHElevateToRoot</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will grant the non-root users with root account privileges.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SSHFailoverToSu</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will use the su command if the sudo command fails.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SSHPassword</span></p>
        </td>
        <td>
          <p>Specifies the password you want to use to authenticate against individual computers in a protection group.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SSHPort</span></p>
        </td>
        <td>
          <p>Specifies the Web service port to connect to Linux-based machines.</p><p>Default: <code>443</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>UInt16</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SSHRootPassword</span></p>
        </td>
        <td>
          <p>Specifies the root password used for authentication.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SSHTempCredentials</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will use single-use credentials to access Linux-based machines.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SSHUser</span></p>
        </td>
        <td>
          <p>Specifies the user name you want to use to authenticate against individual computers in a protection group.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">UseTemporaryCertificate</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will use temporary certificate.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

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 [`VBRIndividualComputerCustomCredentials`](vbrindividualcomputercustomcredentials.md) object that contains a method for authenticating individual computers.

## Examples

::: example
### Specifying Credentials for Authenticating with Individual Computers

This example shows how to specify credentials for authenticating individual computers.

```
$ccreds = Get-Credential
New-VBRIndividualComputerCustomCredentials -HostName 172.19.51.50 -Credentials $creds
```

Perform the following steps:

1. Run the [`Get-Credential`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.4) cmdlet. Type the credentials and save the result to the `$ccreds` variable.
2. Run the `New-VBRIndividualComputerCustomCredentials` cmdlet. Specify the `HostName` parameter value. Set the `$ccreds` variable as the `Credentials` parameter value.

:::

## Related Commands

[`New-VBRIndividualComputerContainer`](new-vbrindividualcomputercontainer.md)