---
title: "New-VBOLinuxCredential"
description: "This cmdlet creates the VBOLinuxCredential object. This object contains Linux credentials to connect to a Linux-based backup proxy server."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/new-vbolinuxcredential.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Backup Proxy Servers > New-VBOLinuxCredential"
dateModified: "2026-08-21"
---

# New-VBOLinuxCredential

## Short Description
Creates the Linux credentials record to connect to a Linux-based backup proxy server.

## Syntax
```
New-VBOLinuxCredential [-SshPort <Int32>] [-ConnectionTimeout <Int32>] -Account <String>
 [-Password <SecureString>] [-PrivateKeyFilePath <String>] [-Passphrase <SecureString>] [-ElevateAccountToRoot]
 [-AddToSudoers] [-UseSuIfSudoUnavailable] [-RootPassword <SecureString>] [-Fingerprint <String>]
 [-PublicKeyBase64 <String>] [-IgnoreFingerprintCheck] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the [`VBOLinuxCredential`](vbolinuxcredential.md) object. This object contains Linux credentials to connect to a Linux-based backup proxy server.

## 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 a user name. The cmdlet will use this account for authentication to a Linux-based backup proxy server.</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>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 a user account to <em>sudoers</em> file.</p><p>Default: <em>False</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">ConnectionTimeout</span></p>
        </td>
        <td>
          <p>Specifies the SSH connection timeout in <em>milliseconds</em>. Veeam Backup for Microsoft 365 uses this timeout to wait for connection to a Linux-based backup proxy server through SSH.</p><p>Default: <em>30000</em></p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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 cmdlet will provide non-root users with root account privileges.</p><p>Default: <em>False</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">Fingerprint</span></p>
        </td>
        <td>
          <p>Specifies the SSH host fingerprint.</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">IgnoreFingerprintCheck</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup for Microsoft 365 will skip verification of the SSH fingerprint on a target Linux machine.</p><p>Default: <em>False</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>For the Identity/Pubkey authentication method.</p><p>Specifies a passphrase for a Linux private key.</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. The cmdlet will use this password for authentication to a Linux-based backup proxy 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>For the Identity/Pubkey authentication method.</p><p>Specifies the private key file path.</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">PublicKeyBase64</span></p>
        </td>
        <td>
          <p>Specifies the content of the public key file provided as a Base64 string.</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 a root password for authentication.</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">SshPort</span></p>
        </td>
        <td>
          <p>Specifies a port number. The cmdlet will use this port to connect to a Linux-based backup proxy server through SSH.</p><p>Permitted values: 1–65535.</p><p>Default: <em>22</em></p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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 Veeam Backup for Microsoft 365 will use the <code>su</code> command if the <code>sudo</code> command is not available.</p><p>Default: <em>False</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>
    </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 Learn.

## Output Object
The cmdlet returns the [`VBOLinuxCredential`](vbolinuxcredential.md) object that contains Linux credentials.

## Examples

::: example
### Creating Linux Credentials Record

This example shows how to create a new record with Linux credentials for a Linux-based backup proxy server.

```
$linuxpwd = ConvertTo-SecureString -String "Pa$$word123" -AsPlainText -Force
New-VBOLinuxCredential -Account "Administrator" -ElevateAccountToRoot:$true -Password $linuxpwd
```

Perform the following steps:

1. Run the [`ConvertTo-SecureString`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/convertto-securestring) cmdlet. Specify the necessary parameters. Save the result to the `$linuxpwd` variable.
2. Run the `New-VBOLinuxCredential` cmdlet. Specify the following settings:

   - Specify the `Account` parameter value.
   - Set the `true` value for the `ElevateAccountToRoot` parameter.
   - Set the `$linuxpwd` variable as the `Password` parameter value.

:::

## Related Commands

[``ConvertTo-SecureString``](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/convertto-securestring)