---
title: "New-VEORLinuxCredential"
description: "Creates a Linux credential record to connect to a Linux machine. Product: Veeam Backup & Replication Product Edition: Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates a Linux credential record."
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/new-veorlinuxcredential.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Oracle > New-VEORLinuxCredential"
dateModified: "2026-08-18"
---

# New-VEORLinuxCredential

## Short Description
Creates a Linux credential record to connect to a Linux machine.

**Product**: Veeam Backup & Replication

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

## Syntax
```
New-VEORLinuxCredential [-Account] <String> [-Password <SecureString>] [-PrivateKeyFilePath <String>]
 [-Passphrase <SecureString>] [-ElevateAccountToRoot] [-AddToSudoers] [-UseSuIfSudoUnavailable]
 [-RootPassword <SecureString>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates a Linux credential record. You can use this credential record to connect to the Oracle database and restore this database to a Linux machine.

Run the [`Restore-VEORDatabase`](restore-veordatabase.md) cmdlet to restore an Oracle database.

Run the [`Restore-VEORRMANDatabase`](restore-veorrmandatabase.md) cmdlet to restore Oracle databases backed up with Veeam Plug-in for Oracle RMAN.

## 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">Account</span></p>
        </td>
        <td>
          <p>Specifies the user name of the account that will be used to connect to the target Linux server.</p><p><strong>Note</strong>: The account must be a member of the <em>dba</em> 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>0</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">AddToSudoers</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add the account to <em>sudoers</em>.</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ElevateAccountToRoot</span></p>
        </td>
        <td>
          <p>Defines that the account must be elevated to <em>root</em>.</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Passphrase</span></p>
        </td>
        <td>
          <p>Specifies a passphrase that the cmdlet will use to connect to the target Linux server.</p>
        </td>
        <td style="width:10%;">
          <p><code>SecureString</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Password</span></p>
        </td>
        <td>
          <p>Specifies a password that will be used to connect to the target Linux server.</p>
        </td>
        <td style="width:10%;">
          <p><code>SecureString</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PrivateKeyFilePath</span></p>
        </td>
        <td>
          <p>Specifies the path for the private key that the cmdlet will use to connect to the target Linux server.</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RootPassword</span></p>
        </td>
        <td>
          <p>Specifies the <em>root</em> password.</p>
        </td>
        <td style="width:10%;">
          <p><code>SecureString</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">UseSuIfSudoUnavailable</span></p>
        </td>
        <td>
          <p>Defines that the <em>Su</em> command is used instead of the <em>Sudo</em> command.</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>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Docs.

## Output Object
The cmdlet returns the [`VEORLinuxCredential`](veorlinuxcredential.md) object that contains a Linux credential record.

## Examples

::: example
### Example 1. Creating Linux Credential Record with Password

This example shows how to create a Linux credential record with the password authentication method. Veeam Explorer for Oracle will use these credentials to connect to the target Linux machine.

```
$securepassword = Read-Host -Prompt "Enter password" -AsSecureString
$credentials = New-VEORLinuxCredential -Account "root" -Password $securepassword
```

Perform the following steps:

1. Run the [`Read-Host`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/read-host?view=powershell-7.6) cmdlet to create a secure password. Enter credentials that will be used to connect to the target Linux server. Provide the `AsSecureString` parameter. Save the result to the `$securepassword` variable.
2. Run the `New-VEORLinuxCredential` cmdlet. Specify the `Account` parameter value. Set the `$securepassword` variable as the `Password` parameter value. Save the result to the `$credentials` variable to use it with other cmdlets.

:::

::: example
### Example 2. Creating Linux Credential Record with Private Key

This example shows how to create a Linux credential record with the private key authentication method. Veeam Explorer for Oracle will use these credentials to connect to the target Linux machine.

```
$securepassword = Read-Host -Prompt "Enter secure string" -AsSecureString
$credentials = New-VEORLinuxCredential -Account "root" -PrivateKeyFilePath "/home/.ecryptfs/<user>/.Private/" -Passphrase $securepassword
```

Perform the following steps:

1. Run the [`Read-Host`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/read-host?view=powershell-7.6) cmdlet to create a secure password. Enter credentials that will be used to connect to the target Linux server. Provide the `AsSecureString` parameter. Save the result to the `$securepassword` variable.
2. Run the `New-VEORLinuxCredential` cmdlet. Specify the following settings:

   - Specify the `Account` parameter value.
   - Specify the `PrivateKeyFilePath` parameter value.
   - Set `$securepassword` variable as the `Passphrase` parameter value.

   Save the result to the `$credentials` variable to use it with other cmdlets.

:::

## Related Commands

[``Read-Host``](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/read-host?view=powershell-7.6)