New-VEPSQLLinuxCredential

Short Description

Creates Linux credential record to connect to a Linux machine.

Applies to

Veeam Backup & Replication

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

New-VEPSQLLinuxCredential [-Account] <String> [-Password <SecureString>] [-PrivateKeyFilePath <String>] [-Passphrase <SecureString>] [-ElevateAccountToRoot <SwitchParameter>] [-AddToSudoers <SwitchParameter>] [-UseSuIfSudoUnavailable <SwitchParameter>] [-RootPassword <SecureString>] [<CommonParameters>]

Detailed Description

This cmdlet creates a Linux credential record. You can use this credential record to connect to PostgreSQL and perform operations with PostgreSQL instances and databases.

Run the Start-VEPSQLInstanceRestore cmdlet to restore a PostgreSQL instance to a Linux machine.
Run the Start-VEPSQLInstancePublish cmdlet to publish a PostgreSQL instance.
Run the Start-VEPSQLDatabaseExport cmdlet to export a PostgreSQL database.
Run the Start-VEPSQLInstanceInstantRecovery cmdlet to perform instant recovery of a PostgreSQL instance.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Account	Specifies the user name of the account that will be used to connect to the target Linux server.	String	True	0	False
AddToSudoers	Defines that the cmdlet will add the account to the sudoers file.	SwitchParameter	False	Named	False
ElevateAccountToRoot	Defines that the account must be elevated to root.	SwitchParameter	False	Named	False
Passphrase	Specifies a passphrase. The cmdlet will use that passphrase to connect to the target Linux server.	SecureString	False	Named	False
Password	Specifies a password that will be used to connect to the target Linux server.	SecureString	False	Named	False
PrivateKeyFilePath	Specifies the path for the private key. The cmdlet will use that key to connect to the target Linux server.	String	False	Named	False
RootPassword	Specifies the root password.	SecureString	False	Named	False
UseSuIfSudoUnavailable	Defines that the su command is used instead of the sudo command.	SwitchParameter	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

The cmdlet returns the VEPSQLLinuxCredential object that contains a Linux credential record.

Examples

New-VEPSQLLinuxCredential 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 PostgreSQL will use these credentials to connect to the target Linux machine.

$securepassword = Read-Host -Prompt "Enter password" -AsSecureString

$credentials = New-VEPSQLLinuxCredential -Account "root" -Password $securepassword

Perform the following steps:

Run the Read-Host 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.
Run the New-VEPSQLLinuxCredential 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.

New-VEPSQLLinuxCredential 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 PostgreSQL will use these credentials to connect to the target Linux machine.

$securepassword = Read-Host -Prompt "Enter secure string" -AsSecureString

$credentials = New-VEPSQLLinuxCredential -Account "root" -PrivateKeyFilePath "/home/.ecryptfs/<user>/.Private/" -Passphrase $securepassword

Perform the following steps:

Run the Read-Host 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.
Run the New-VEPSQLLinuxCredential cmdlet. Specify the following settings:

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

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

Related Commands

Read-Host