Get-DbaPageFileSetting

Want to see the source code for this command? Check out Get-DbaPageFileSetting on GitHub.
Want to see the Bill Of Health for this command? Check out Get-DbaPageFileSetting.

Synopsis

Retrieves Windows page file configuration from SQL Server host computers for performance analysis.

Description

This command uses CIM to retrieve detailed Windows page file configuration from SQL Server host computers. Page file settings directly impact SQL Server performance during memory pressure scenarios, making this essential for capacity planning and troubleshooting performance issues.

The function returns comprehensive details including current usage, peak usage, initial and maximum sizes, and whether page files are automatically managed by Windows. This information helps DBAs identify potential memory bottlenecks and validate that page file configurations align with SQL Server best practices.

Note that this may require local administrator privileges for the relevant computers.

Syntax

Get-DbaPageFileSetting
    [[-ComputerName] <DbaInstanceParameter[]>]
    [[-Credential] <PSCredential>]
    [-EnableException]
    [<CommonParameters>]

Examples

Example: 1

PS C:\> Get-DbaPageFileSetting -ComputerName ServerA,ServerB

Returns a custom object displaying ComputerName, AutoPageFile, FileName, Status, LastModified, LastAccessed, AllocatedBaseSize, InitialSize, MaximumSize, PeakUsage, CurrentUsage for ServerA and
ServerB

Example: 2

PS C:\> 'ServerA' | Get-DbaPageFileSetting

Returns a custom object displaying ComputerName, AutoPageFile, FileName, Status, LastModified, LastAccessed, AllocatedBaseSize, InitialSize, MaximumSize, PeakUsage, CurrentUsage for ServerA

Optional Parameters

-ComputerName

Specifies the target SQL Server host computers to retrieve page file settings from. Accepts computer names, IP addresses, or SQL Server instance names.
Use this to analyze page file configurations across your SQL Server infrastructure for capacity planning and performance troubleshooting.
Defaults to the local computer if not specified.

-Credential

Credential object used to connect to the Computer as a different user

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