---
title: "New-VBRCSVCustomCredentials"
description: "Specifies custom credentials for authenticating with computers listed in a CSV file. Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet specifies custom credentials for authenticating with computers"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrcsvcustomcredentials.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Protection Groups > Veeam Agent Management Protection Scope > New-VBRCSVCustomCredentials"
dateModified: "2026-08-19"
---

# New-VBRCSVCustomCredentials

## Short Description
Specifies custom credentials for authenticating with computers listed in a CSV file.

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

## Syntax
```
New-VBRCSVCustomCredentials -HostName <String> [-Credentials <CCredentials>] [<CommonParameters>]
```

## Detailed Description
This cmdlet specifies custom credentials for authenticating with computers you want to add to a protection group from a CSV file. Veeam Backup & Replication uses these credentials for Veeam Agent deployment and backup\\restore activities.

By default, Veeam Backup & Replication uses Master account credentials for authenticating with all computers listed in a CSV file. For authenticating with computers that require different credentials Veeam Backup & Replication uses custom credentials.

## 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 custom credentials for authenticating with computers listed in a CSV file.</p><p>If not set, Veeam Backup & Replication will use Master account credentials for authenticating with associated computers.</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>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">HostName</span></p>
        </td>
        <td>
          <p>Specifies DNS-name or IP address of the computer for which you want to specify 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>
    </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
[`VBRCSVCustomCredentials`](vbrcsvcustomcredentials.md)

## Examples

::: example
### Example 1. Setting Custom Credentials for Computers from CSV File

This example shows how to specify custom credentials for computers from a CSV file.

```
$ccreds = Get-Credential
@("172.19.51.55", "sup-v8931") | ForEach { New-VBRCSVCustomCredentials -HostName $_ -Credentials $ccreds}
```

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) to create a credential object you want to use for authenticating with computers. Type the credentials and save the result to the `$ccreds` variable.
2. Run the `New-VBRCSVCustomCredentials` cmdlet. Set the `$ccreds` variable as the `Credentials` parameter value. Use the `ForEach` statement to apply the same credentials to multiple computers.

:::

::: example
### Example 2. Setting Master Credentials for Computers from CSV File

This command specifies master credentials for the computer from a CSV file.

```
New-VBRCSVCustomCredentials -HostName 172.19.51.50
```

:::

## Related Commands

[`New-VBRCSVContainer`](new-vbrcsvcontainer.md)