---
title: "New-VBRCSVContainer"
description: "Creates a scope of computers listed in a CSV file. Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates the VBRCSVContainer object."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrcsvcontainer.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Protection Groups > Veeam Agent Management Protection Scope > New-VBRCSVContainer"
dateModified: "2026-08-19"
---

# New-VBRCSVContainer

## Short Description
Creates a scope of computers listed in a CSV file.

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

## Syntax
```
New-VBRCSVContainer -Path <String> [-NetworkCredentials <CCredentials>] -MasterCredentials <CCredentials>
 [-UseCustomCredentials] [-CustomCredentials <VBRCSVCustomCredentials[]>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the [`VBRCSVContainer`](vbrcsvcontainer.md) object. This object contains a scope of computers listed in a CSV file. Use this object to create a protection group with the [`Add-VBRProtectionGroup`](add-vbrprotectiongroup.md) cmdlet.

## 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">CustomCredentials</span></p>
        </td>
        <td>
          <p>Specifies custom credentials for authenticating with associated computers.</p><p>Accepts the <a href="vbrcsvcustomcredentials.md"><code>VBRCSVCustomCredentials[]</code></a> object. To get this object, run the <a href="new-vbrcsvcustomcredentials.md"><code>New-VBRCSVCustomCredentials</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcsvcustomcredentials.md"><code>VBRCSVCustomCredentials[]</code></a></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">MasterCredentials</span></p>
        </td>
        <td>
          <p>Specifies Master account credentials for authenticating with all computers listed in a CSV file.</p><p>For authenticating with computers that require different credentials, Veeam Backup & Replication uses custom credentials. If you want to use custom credentials for some computers, set the <code>UseCustomCredentials</code> parameter.</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">NetworkCredentials</span></p>
        </td>
        <td>
          <p>Specifies the credentials you want to use for authenticating with the shared folder. The cmdlet will use these credentials if a CSV file is located on a file share.</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">Path</span></p>
        </td>
        <td>
          <p>Specifies the path to the CSV file. The cmdlet will import computer DNS names or IP addresses from this file.</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">UseCustomCredentials</span></p>
        </td>
        <td>
          <p>Defines that you want to use custom credentials for authenticating with some computers listed in a CSV file.</p><p>To specify custom credentials, use the <code>CustomCredentials</code> parameter.</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>
    </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
[`VBRCSVContainer`](vbrcsvcontainer.md)

## Examples

::: example
### Example 1. Creating Scope of Computers from CSV File on Computer

This example shows how to create a scope of computers from a CSV file located on your computer.

```
$ccreds = Get-Credential
$custom = @("172.19.51.55", "sup-v8931") | ForEach { New-VBRCSVCustomCredentials -HostName $_ -Credentials $ccreds}
$netcreds = Get-Credential
New-VBRCSVContainer -Path "C:\Computers.csv" -MasterCredentials support\jsmith -UseCustomCredentials -CustomCredentials $custom
```

Perform the following steps:

1. Specify custom credentials for computers from a CSV file:

   - 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.
   - Run the [`New-VBRCSVCustomCredentials`](new-vbrcsvcustomcredentials.md) cmdlet. Set the `$ccreds` variable as the `Credentials` parameter value. Use the `ForEach` statement to apply the same credentials to multiple computers. Save the result to the `$custom` variable.

2. Run the `New-VBRCSVContainer` cmdlet. Specify the following settings:

   - Specify the `Path` parameter value.
   - Specify the `MasterCredentials` parameter value.
   - Provide the `UseCustomCredentials` parameter value.
   - Set the `$custom` variable as the `CustomCredentials` parameter value.

:::

::: example
### Example 2. Creating Scope of Computers from CSV File on File Share

This example shows how to create a scope of computers from a CSV file located on a file share.

```
$ccreds = Get-Credential
$custom = @("172.19.51.55", "sup-v8931") | ForEach { New-VBRCSVCustomCredentials -HostName $_ -Credentials $ccreds}
$netcreds = Get-Credential
New-VBRCSVContainer -Path "//support.local/east/Computers.csv" -MasterCredentials support\jsmith -NetworkCredentials $netcreds -UseCustomCredentials -CustomCredentials $custom
```

Perform the following steps:

1. Specify custom credentials for computers from a CSV file:

   - 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.
   - Run the [`New-VBRCSVCustomCredentials`](new-vbrcsvcustomcredentials.md) cmdlet. Set the `$ccreds` variable as the `Credentials` parameter value. Use the `ForEach` statement to apply the same credentials to multiple computers. Save the result to the `$custom` variable.

2. Run the [`Get-Credential`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.4) cmdlet to create a credential object you want to use for authenticating with the shared folder. Type the credentials and save the result to the `$netcreds` variable.
3. Run the `New-VBRCSVContainer` cmdlet. Specify the following settings:

   - Specify the `Path` parameter value.
   - Specify the `MasterCredentials` parameter value.
   - Set the `$netcreds` variable as the `NetworkCredentials` parameter value.
   - Provide the `UseCustomCredentials` parameter value.
   - Set the `$custom` variable as the `CustomCredentials` parameter value.

:::

::: example
### Example 3. Creating Protection Group with Scope of Computers from CSV File on File Share

This example shows how to create a protection group with a scope of computers from a CSV file.

```
$ccreds = Get-Credential
$custom = @("172.19.51.55", "sup-v8931") | ForEach { New-VBRCSVCustomCredentials -HostName $_ -Credentials $ccreds}
$netcreds = Get-Credential
$csvscope = New-VBRCSVContainer -Path "//support.local/east/Computers.csv" -MasterCredentials support\jsmith -NetworkCredentials $netcreds -UseCustomCredentials -CustomCredentials $custom
Add-VBRProtectionGroup -Name "CSV" -Container $csvscope
```

Perform the following steps:

1. Specify custom credentials for computers from a CSV file:

   - 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.
   - Run the [`New-VBRCSVCustomCredentials`](new-vbrcsvcustomcredentials.md) cmdlet. Set the `$ccreds` variable as the `Credentials` parameter value. Use the `ForEach` statement to apply the same credentials to multiple computers. Save the result to the `$custom` variable.

2. Run the [`Get-Credential`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.4) cmdlet to create a credential object you want to use for authenticating with the shared folder. Type the credentials and save the result to the `$netcreds` variable.
3. Run the `New-VBRCSVContainer` cmdlet. Specify the `Path` and the `MasterCredentials` parameter values. Set the `$netcreds` variable as the `NetworkCredentials` parameter value. Provide the `UseCustomCredentials` parameter value. Set the `$custom` variable as the `CustomCredentials` parameter value. Save the result to the `$csvscope` variable.
4. Create a protection group. To do this, run the [`Add-VBRProtectionGroup`](add-vbrprotectiongroup.md) cmdlet. Specify the `Name` parameter value. Set the `$csvscope` variable as the `Container` parameter value.

:::

## Related Commands

- [`New-VBRCSVCustomCredentials`](new-vbrcsvcustomcredentials.md)
- [`Add-VBRProtectionGroup`](add-vbrprotectiongroup.md)