Add-VBRCloudGatewayCertificate

Short Description

Assigns a TLS certificate to the service provider.

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides the following parameter sets:

FromStore

Add-VBRCloudGatewayCertificate -Certificate <VBRCloudCertificate>

[-WhatIf] [-Confirm] [<CommonParameters>]
FromFile

Add-VBRCloudGatewayCertificate -CertificatePath <String> -PrivateKeyPath <String> [-Password <SecureString>]

[-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet assigns a TLS certificate to the service provider.

Important

You can only use the TLS certificate imported from the certificate store.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Certificate	Specifies the certificate you want to use. Accepts the `VBRCloudCertificate` object. To get this object, run the `Get-VBRCloudGatewayCertificate` cmdlet.	`VBRCloudCertificate`	True	Named	True (ByPropertyName, ByValue)
CertificatePath	Specifies the full path to the PFX file associated with the certificate.	`String`	True	Named	False
Password	Specifies the full path to the KEY file associated with the certificate.	`SecureString`	False	Named	False
PrivateKeyPath	Specifies a secure string that contains the password for the certificate file, if the file is protected.	`String`	True	Named	False
Confirm	Defines that the cmdlet will display a prompt that asks if you want to continue running the command.	`SwitchParameter`	False	Named	False
WhatIf	Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.	`SwitchParameter`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Examples

Add-VBRCloudGatewayCertificate Example 1. Assigning Certificate using Certificate Files

This example shows how to assign a certificate using certificate files.

Add-VBRCloudGatewayCertificate -CertificatePath "C:\Certs\TechCompany.pfx" -PrivateKeyPath "C:\Certs\OmegaCompany.key" -Password (Read-Host -AsSecureString "Enter certificate password")

Add-VBRCloudGatewayCertificate Example 2. Assigning TLS Certificate to Service Provider

This example shows how to get a certificate from the certificate store and assign it to the service provider.

$certificate = Get-VBRCloudGatewayCertificate -FromStore | Where FriendlyName -eq "Omega Company"

Add-VBRCloudGatewayCertificate -Certificate $certificate

Perform the following steps:

Run the Get-VBRCloudGatewayCertificate cmdlet. Provide the FromStore parameter value. Pipe the cmdlet output to the Where command to filter certificates by the FriendlyName parameter. Save the result to the $certificate variable.
Run the Add-VBRCloudGatewayCertificate cmdlet. Set the $certificate variable as the Certificate parameter value.

Get-VBRCloudGatewayCertificate