Get-DbaRgResourcePool

Synopsis

Retrieves SQL Server Resource Governor resource pools with their CPU, memory, and IOPS configuration settings

Description

Retrieves detailed information about SQL Server Resource Governor resource pools, including both internal (CPU/memory) and external (R/Python) pools. Shows current configuration settings for minimum and maximum CPU percentages, memory percentages, and IOPS limits per volume. Essential for monitoring resource allocation, troubleshooting performance bottlenecks, and auditing resource governance policies across your SQL Server instances.

Syntax

Get-DbaRgResourcePool
    [[-SqlInstance] <DbaInstanceParameter[]>]
    [[-SqlCredential] <PSCredential>]
    [[-Type] <String>]
    [[-InputObject] <ResourceGovernor[]>]
    [-EnableException]
    [<CommonParameters>]

Examples

Example: 1

PS C:\> Get-DbaRgResourcePool -SqlInstance sql2016

Gets the internal resource pools on sql2016

Example: 2

PS C:\> 'Sql1','Sql2/sqlexpress' | Get-DbaResourceGovernor | Get-DbaRgResourcePool

Gets the internal resource pools on Sql1 and Sql2/sqlexpress instances

Example: 3

PS C:\> 'Sql1','Sql2/sqlexpress' | Get-DbaResourceGovernor | Get-DbaRgResourcePool -Type External

Gets the external resource pools on Sql1 and Sql2/sqlexpress instances

Optional Parameters

-SqlInstance

The target SQL Server instance or instances

-SqlCredential

Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential).
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported.
For MFA support, please use Connect-DbaInstance.

-Type

Specifies whether to retrieve Internal resource pools (CPU/memory) or External resource pools (R/Python services).
Internal pools control SQL Server workloads, while External pools govern Machine Learning Services resource consumption.

-InputObject

Accepts Resource Governor objects from Get-DbaResourceGovernor for pipeline processing.
Use this when you need to filter or process resource pools from multiple instances collected earlier in your script.

-EnableException

By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
This avoids overwhelming you with “sea of red” exceptions, but is inconvenient because it basically disables advanced scripting.
Using this switch turns this “nice by default” feature off and enables you to catch exceptions with your own try/catch.