Get-DbatoolsConfig

Synopsis

Retrieves dbatools module configuration settings and preferences.

Description

Retrieves dbatools module configuration settings that control how dbatools functions behave. These settings include connection timeouts, default paths, email configurations, and other module preferences that affect dbatools operations. Use this command to view current settings, troubleshoot dbatools behavior, or identify what configurations are available for customization with Set-DbatoolsConfig.

Syntax

Get-DbatoolsConfig
    [[-FullName] <String>]
    [-Force]
    [<CommonParameters>]

Get-DbatoolsConfig
    [[-Name] <String>]
    [[-Module] <String>]
    [-Force]
    [<CommonParameters>]

Examples

Example: 1

PS C:\> Get-DbatoolsConfig 'Mail.To'

Retrieves the configuration element for the key “Mail.To”

Example: 2

PS C:\> Get-DbatoolsConfig -Force

Retrieve all configuration elements from all modules, even hidden ones.

Optional Parameters

-FullName

Default: “*”
Specifies the complete configuration key in Module.Name format to retrieve specific dbatools settings.
Use this to find exact configuration values like “sql.connection.timeout” or “mail.smtpserver” without needing to specify module and name separately.
Supports wildcards for pattern matching across all configuration keys.

-Name

Default: “*”
Specifies the configuration name to search for within a specific module.
Use this with the Module parameter to find settings like “timeout” within the “sql” module or “smtpserver” within the “mail” module.
Supports wildcards for finding multiple related configuration names.

-Module

Default: “*”
Specifies which dbatools module’s configuration settings to retrieve.
Use this to focus on specific areas like “sql” for connection settings, “mail” for email configurations, or “path” for default file locations.
Commonly used modules include sql, mail, path, and logging.

-Force

Includes hidden configuration values that are normally not displayed in the output.
Use this when troubleshooting dbatools behavior or when you need to see internal configuration settings that control advanced module functionality.
Hidden settings often include debugging flags and internal module state information.