The components utility allows you to manage Windows server components.

You can use this utility to enable and disable components, as well as assign application packages to a component.

You can also use this utility to update an application package.

Location

%plesk_cli%

Usage 

components <command> [
<option_1> [<param>]
[<option_2> [<param>]]
]

Examples

The following command lists all components and their associated packages:

plesk bin components --list

The following command assigns the drweb package to the antivirus component, so that subscriptions can use Dr. Web’s Premium Antivirus as their antivirus.

plesk bin components --set-package -component antivirus -package drweb

The following command shows all configuration parameters for the smartermail_remote package:

plesk bin components --show-package-parameters -package smartermail_remote

The following command configures the SmarterMail package to accept the example credentials:

plesk bin components --set-package-parameters -package smartermail_remote 'host=localhost' 'login=example' 'password=123456'

Commands

Command

Parameter

Description

Example

--help or -h

Displays help on the utility usage.

To view help on the use of this utility:

plesk bin components --help

--list or -l

Lists all information from all components.

To list all components’ information:

plesk bin components --list

--show-package-parameters

Shows all available configuration parameters for a specific package.

To show all configuration parameters for the smartermail_remote package:

plesk bin components --show-package-parameters -package smartermail_remote

--set-package-parameters

Sets the parameters of a specific package.

To configure the SmarterMail package to accept the following credentials:

plesk bin components --set-package-parameters -package smartermail_remote 'host=localhost' 'login=example' 'password=123456'

--set-package or -s

Assigns a specific package to a component.

To assign the drweb package to the antivirus component, so that subscriptions can use Dr. Web’s Premium Antivirus as their antivirus.

plesk bin components --set-package -component antivirus -package drweb

Options

Option

Parameter

Description

Example

-component

Specifies the component to modify.

Used with --set-package.

To assign the drweb package to the antivirus component, so that subscriptions can use Dr. Web’s Premium Antivirus as their antivirus.

plesk bin components --set-package -component antivirus -package drweb

-package

Specifies the package to modify.

Used with --set-package, --show-package-parameters, --set-package-parameters.

To disable the drweb package globally:

plesk bin components --set-package -package drweb -disable

-enable

Enables a package. If a component is not specified, the component is enabled globally.

Used with --set-package.

To enable the smartermail_remote package for the email component:

plesk bin components --set-package -package smartermail_remote -enable

-disable

Disables a package. If a component is not specified, the component is disabled globally.

Used with --set-package.

To disable the smartermail_remote package globally:

plesk bin components --set-package -package smartermail_remote -disable

Package-Specific Parameters

The --show-package-parameters parameter returns package-specific parameters, including both required and optional parameters. The return will resemble the following example:

plesk bin components --show-package-parameters -package smartermail_remote

Required parameters:

  • host (string) - Hostname (current: localhost)

  • login (string) - User login (current: example)

  • password (string) - Login Password (current: ***)

  • port (int) - Port (current: 111)

Optional parameters:

  • ssl (bool) - HTTPS protocol (current: false)

  • ssl_cert_failure_check (bool) - Check SSL certificate (current: true)

These parameters show their data types and current statuses. They can be modified with the --set-package-parameters parameter by adding an updated value of the correct data type.

For example, the following command modifies the smartermail_remote package to use the HTTPS protocol to connect securely:

plesk bin components --set-package-parameters -package smartermail_remote 'ssl:true'