Start-VEMDBPublishJob
Short Description
Publishes a backed-up MongoDB instance.
Applies to
Veeam Backup & Replication
Product Edition: Enterprise Plus, Veeam Universal License
Syntax
Start-VEMDBPublishJob [-Session] <VEMDBRestoreSession> [-PublishInstancePort <Int32>] [-Server <String>] [-SshPort <Int32>] -Credential <VEMDBLinuxCredentials> [-ToPointInTimeUTC <DateTime>] [-RestoreInstancePort <Int32>] [-InstanceCredentials <PSCredential>] [-UseTLS] [-UseSystemCertificateAuthority] [-CertificateAuthorityPemFilePath <String>] [-UseX509Authentication] [-ClientCertificateAndKeyPemFilePath <String>] [-ClientKeyPassword <SecureString>] [-Force] [<CommonParameters>] |
Detailed Description
This cmdlet publishes a backed-up MongoDB instance.
Parameters
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
---|---|---|---|---|---|
Session | Specifies a restore session initiated to perform operations with MongoDB. | Accepts the VEMDBRestoreSession object. To get this object, run the Get-VEMDBRestoreSession cmdlet. | True | 0 | True (ByValue) |
CertificateAuthorityPemFilePath | Specifies the path to the custom Certificate Authority (CA) PEM file used to verify the certificate issued to the MongoDB deployment. You can use this parameter with the UseTLS and UseX509Authentication parameters. Note: If you use this parameter, do not specify the UseSystemCertificateAuthority parameter. | String | False | Named | False |
ClientCertificateAndKeyPemFilePath | Specifies the path to the PEM file containing the client certificate and the related private key. You can use this parameter with the UseTLS and UseX509Authentication parameters. | String | False | Named | False |
ClientKeyPassword | Defines the password used to decrypt the private key specified in the ClientCertificateAndKeyPemFilePath parameter. | SecureString | False | Named | False |
Credential | Specifies credentials for authenticating to the primary node of the MongoDB deployment or the target MongoDB server. Note: The user must have root privileges on the target server. | Accepts the VEMDBLinuxCredentials object. To get this object, run the New-VEMDBLinuxCredentials cmdlet. | True | Named | False |
Force | Defines that the cmdlet will show no prompt before executing the command. | SwitchParameter | False | Named | False |
InstanceCredentials | Specifies the credentials for the target MongoDB instance. Consider the following:
| Accepts the PSCredential object. To get this object, run the Get-Credential cmdlet. | False | Named | False |
PublishInstancePort | Specifies a port for the published MongoDB instance. | Int32 | False | Named | False |
RestoreInstancePort | Specifies the port of the instance to which the contents of the published MongoDB instance will be restored. Default: 27017 | Int32 | False | Named | False |
Server | Specifies DNS name or IP address of the primary node of the target MongoDB deployment or the target MongoDB server. | String | False | Named | False |
SshPort | Specifies the SSH port number that the cmdlet will use to connect to the Linux machine. Default: 22 | Int32 | False | Named | False |
ToPointInTimeUTC | Specifies a point in time in the UTC format within the restore interval of the MongoDB instance. The cmdlet will publish the instance to the state of the specified point in time. If you do not use this parameter, the cmdlet will restore the instance to the point in time when the restore point for which you started the restore session was created. | DateTime | False | Named | False |
UseSystemCertificateAuthority | Defines that the cmdlet will use the Certificate Authority (CA) store of the mount server associated with the backup repository to verify the certificate issued to the MongoDB deployment. You can use this parameter with the UseTLS and UseX509Authentication parameters. Note: If you use this parameter, do not specify the CertificateAuthorityPemFilePath parameter. | SwitchParameter | False | Named | False |
UseTLS | Defines that the cmdlet will connect to the target MongoDB deployment using a secure TLS protocol. Note: This parameter is obligatory if you use the UseX509Authentication parameter and optional if you use the InstanceCredentials parameter. | SwitchParameter | False | Named | False |
UseX509Authentication | Defines that the cmdlet will use X.509 authentication to connect to the target MongoDB deployment. Note: If you use this parameter, do not specify the InstanceCredentials parameter. | SwitchParameter | False | Named | False |
<CommonParameters>
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 VEMDBInstancePublish[] array that contains information about the publishing process for the MongoDB instance.
Example
Example 1. Publishing MongoDB Instance
This example shows how to publish a backed-up MongoDB instance to a machine with MongoDB. This is a temporary operation for testing or development purposes, which allows you to check the data contained in the MongoDB instance. This example uses the TLS protocol to connect to the target MongoDB deployment.
Perform the following steps:
Save the result to the $publish variable to be able to use it with other cmdlets. |
Example 2. Publishing MongoDB Instance to Restore Collections to Point-in-Time State
This example shows how to publish a backed-up MongoDB instance to a specific point-in-time state, which allows you to restore the collections contained in the instance to that point-in-time state. This example uses X.509 authentication to connect to the target MongoDB deployment.
Perform the following steps:
Save the result to the $publish variable to be able to use it with other cmdlets. |
Related Commands