Cmdlet

Use this section to describe a cmdlet available for an operation. The section structure consists of the following elements:

  1. Short description — a short description of the cmdlet.

Start the description with a verb. Keep the description as short as possible so that users can grasp the main idea of the cmdlet functionality right from the short description. Do not add details on how the cmdlet works at this point.

  1. Applies to — a list of system requirements that must be met to perform operations with the product PowerShell.
  2. Syntax — the cmdlet syntax.

Depending on whether the cmdlet has either one parameter set or multiple parameter sets, add the following information:

  • For one parameter set, use a syntax box to list the parameters in this set.
  • For multiple parameter sets, provide a short description for each parameter set. Use multiple syntax boxes to list the parameters in these sets. The default parameter set must be the first entry in the list.
  1. Detailed description — detailed information on the cmdlet.

Specify the purpose of the cmdlet and list operations that can be performed with the cmdlet. Explain how the cmdlet is related to other cmdlets (if any).

  1. Parameters — the cmdlet parameters.

For each parameter, define whether the parameter is required, specify its type and position, and define whether the parameter accepts pipeline input and supports wildcard characters.

If the cmdlet supports Microsoft PowerShell common parameters, include this subsection to provide a link to the Microsoft Common Parameter Reference.

 

Cmdlet Note

For reference topics in Veeam technical documentation, we use slightly different rules from those defined in section Articles. However, these rules apply only to articles used in descriptions of parameters and properties. Particularly, when listing the parameters of a PowerShell cmdlet, we omit an article in a parameter description if it is the first word in the description.

  1. [Optional] Output object — a description for the output object returned by the cmdlet.
  2. Example —  a PowerShell script example that illustrates how to use the cmdlet.
  • If the cmdlet has one parameter set that covers different usage scenarios, provide as many examples as possible to illustrate these scenarios.

First, add the most common scenarios that require minimum parameters. After that, add complex scenarios that require optional parameters.

  • If the cmdlet has multiple parameter sets, provide a separate example for each parameter set.

CmdletExample

Short Description

Connects to a Veeam backup server.

Syntax

This cmdlet provides three parameter sets.

  • To connect as a current user:

Connect-VBRServer [-Server <string>] [-Port <int>]  [<CommonParameters>]

  • To connect using credentials:

Connect-VBRServer -User <string> -Password <string> [-Server <string>] [-Port <int>]  [<CommonParameters>]

  • To connect using PSCredential:

Connect-VBRServer -Credential <pscredential> [-Server <string>] [-Port <int>]  [<CommonParameters>]

Detailed Description

This cmdlet creates a connection with a local or remote Veeam backup server. The connection starts a Veeam PowerShell session during which you can perform all available operations with Veeam PowerShell.

Within one session, you can connect to one Veeam backup server. To connect to another Veeam backup server, you must close the current session. Run Disconnect-VBRServer to stop the session with the currently connected Veeam backup server.

Parameters

Parameter

Description

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

Server

IP address or FQDN of the Veeam backup server to connect to.

Default: localhost.

False

Named

False

False

Port

Port that will be used to connect to the Veeam backup server.

Default: 9392.

False

Named

False

False

User

User name that will be used to authenticate to the Veeam backup server.

Note: The user name must be specified in the DOMAIN\USERNAME format.

True

Named

False

False

Password

Password that will be used to authenticate to the Veeam backup server.

True

Named

False

False

Common Parameters

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

Return Type

None

Example

This command connects to the 172.17.53.36 server using User/Password authentication.

Connect-VBRServer -Server "172.17.53.36" -User "Administrator" -Password "Password"