---
title: "Get-CollectorSettings"
description: "This cmdlet retrieves effective Collector settings for the specified level of the Veeam Collector hierarchy (monitoring group or Collector). The cmdlet returns a list of objects that represent Collector settings."
canonical: "https://helpcenter.veeam.com/docs/mp/veshell/get-collectorsettings.html"
breadcrumb: "Veeam MP VEShell Reference > VEShell Cmdlets > Get-CollectorSettings"
dateModified: "2026-09-10"
---

# Get-CollectorSettings

Gets Collector settings for the specified level of the Veeam Collectors hierarchy (monitoring group or Collector).

**Applies to versions**: 8.0, 9.0, 9a

## Syntax

```
Get-CollectorSettings [-MonitoringGroup] MonitoringGroup [<CommonParameters>]
Get-CollectorSettings [-Collector] Collector [<CommonParameters>]
```

## Detailed Description

This cmdlet retrieves effective Collector settings for the specified level of the Veeam Collector hierarchy (monitoring group or Collector). The cmdlet returns a list of objects that represent Collector settings.

Each setting object is described with the following properties:

Name: name of the Collector setting

Value: effective value of the Collector setting

Type: data type of the Collector setting

Default: default value of the Collector setting

Description: short description of the Collector setting

Inherited: flag that specifies whether objects inherit settings from the upper level

## Parameters

### -MonitoringGroup \<MonitoringGroup\>

Specifies the monitoring group for which Collector settings should be retrieved.

::: tip

To get the list of monitoring groups, use the [`Get-MonitoringGroup`](get-monitoringgroup.md) cmdlet.

:::

<table style="width:500px; head-row-background-color:#c5e2ff; alt-row-background-color:#f5f5f5;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th colspan="2" style="height:19px;">
      <p>Description</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Aliases</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Required?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>True</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Position?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>Named</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Default Value</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Pipeline Input?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>True (ByValue)</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Wildcard Characters?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
</table>

### -Collector \<Collector\>

Specifies the Collector object for which settings are retrieved.

::: tip

To get the list of registered Collectors, their Ids and names, use the [`Get-Collector`](get-collector.md) cmdlet.

:::

<table style="width:500px; head-row-background-color:#c5e2ff; alt-row-background-color:#f5f5f5;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th colspan="2" style="height:19px;">
      <p>Description</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Aliases</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Required?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>True</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Position?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>Named</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Default Value</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Pipeline Input?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>True (ByValue)</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Wildcard Characters?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
</table>

### \<CommonParameters\>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see [Microsoft Docs](http://go.microsoft.com/fwlink/p/?LinkID=113216).

## Input

The cmdlet accepts the following types of values for the `–MonitoringGroup` parameter:

- [Veeam.Psves.MonitoringGroup](monitoring_group.md) (you can pass a monitoring group object)

The cmdlet accepts the following types of values for the `-Collector` parameter:

- [Veeam.Psves.Collector](collector.md) (you can pass a Collector object)

## Output

The cmdlet returns a collection of the [Veeam.Psves.ObjectProperty](collector_settings.md) objects that represent Collector settings.

## Example 1

This command returns a list of Collector settings for the "veeamcol1" Collector.

```
Get-Collector veeamcol1 -SelectByName | Get-CollectorSettings 
```

-OR-

```
$veeamcol1 = Get-Collector veeamcol1 –SelectByName
Get-CollectorSettings $veeamcol1>]
```

## Example 2

This command returns a list of Collector settings for the "Seattle" monitoring group.

```
Get-MonitoringGroup –Include Seattle | Get-CollectorSettings 
```

-OR-

```
$seattleMg = Get-MonitoringGroup –Include Seattle
Get-CollectorSettings $seattleMg
```