---
title: "Get-DbatoolsConfig"
description: "Retrieves dbatools module configuration settings and preferences."
url: "https://dbatools.io/Get-DbatoolsConfig/"
availability: "Windows, Linux, macOS"
tags: ["Module"]
author: "Friedrich Weinmann (@FredWeinmann)"
source: "https://github.com/dataplat/dbatools/blob/master/public/Get-DbatoolsConfig.ps1"
last_updated: "2024-01-01"
---

# 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

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

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

```

## Examples

### Example 1: Retrieves the configuration element for the key &quot;Mail.To&quot;

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

### Example 2: Retrieve all configuration elements from all modules, even hidden ones

```powershell
PS C:\> Get-DbatoolsConfig -Force
```

### 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.

| Property | Value |
| --- | --- |
| Alias |  |
| Required | False |
| Pipeline | false |
| Default Value | * |

##### -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.

| Property | Value |
| --- | --- |
| Alias |  |
| Required | False |
| Pipeline | false |
| Default Value | * |

##### -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.

| Property | Value |
| --- | --- |
| Alias |  |
| Required | False |
| Pipeline | false |
| Default Value | * |

##### -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.

| Property | Value |
| --- | --- |
| Alias |  |
| Required | False |
| Pipeline | false |
| Default Value | False |

## Outputs

**Dataplat.Dbatools.Configuration.ConfigurationValue**

Returns one configuration value object per setting found in the dbatools configuration system that matches the specified filter criteria. Results are sorted alphabetically by module name, then by configuration name.

**Properties:**

- Module: The module name component (e.g., "sql", "mail", "path", "logging")
- Name: The configuration setting name within the module (e.g., "timeout", "smtpserver")
- Value: The current value stored in the configuration setting (can be any object type)
- Description: Human-readable description of what the configuration controls
- Hidden: Boolean indicating if this is a hidden configuration setting
When multiple settings match the filter criteria, each returns a separate object. The full configuration key is in "Module.Name" format (e.g., "sql.connection.timeout"). Hidden settings are excluded by default unless -Force is specified.

---

Part of [dbatools](https://dbatools.io/), a free and open source PowerShell module for SQL Server administration. Full command index: https://dbatools.io/commands/