< Back

Invoke-DbaDbccDropCleanBuffer

Mon Jan 13, 2020 12:11 pm

NAME Invoke-DbaDbccDropCleanBuffer



SYNOPSIS

Execution of Database Console Command DBCC DROPCLEANBUFFERS





SYNTAX

Invoke-DbaDbccDropCleanBuffer [-SqlInstance] <Sqlcollaborative.Dbatools.Parameter.DbaInstanceParameter[]>

[[-SqlCredential] <Pscredential>] [-NoInformationalMessages <Switch>] [-EnableException <Switch>]

[<CommonParameters>]





DESCRIPTION

Allows execution of Database Console Command DBCC DROPCLEANBUFFERS



Removes all clean buffers from the buffer pool, and columnstore objects from the columnstore object pool.



Read more:



- https://docs.microsoft.com/en-us/sql/t- ... ansact-sql





PARAMETERS

-EnableException [<Switch>]

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.



Required? false

Position? named

Default value

Accept pipeline input? False

Accept wildcard characters? false



-NoInformationalMessages [<Switch>]

Suppresses all informational messages.



Required? false

Position? named

Default value

Accept pipeline input? False

Accept wildcard characters? false



-SqlCredential [<Pscredential>]

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.



Required? false

Position? named

Default value

Accept pipeline input? False

Accept wildcard characters? false



-SqlInstance [<Sqlcollaborative.Dbatools.Parameter.DbaInstanceParameter[]>]

The target SQL Server instance or instances.



Required? false

Position? named

Default value

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



NOTES





Tags: DBCC

Author: Patrick Flynn (@sqllensman)



Website: https://dbatools.io

Copyright: (c) 2018 by dbatools, licensed under MIT

License: MIT https://opensource.org/licenses/MIT



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Invoke-DbaDbccDropCleanBuffer -SqlInstance SqlServer2017



Runs the command DBCC DROPCLEANBUFFERS against the instance SqlServer2017 using Windows Authentication

-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Invoke-DbaDbccDropCleanBuffer -SqlInstance SqlServer2017 -NoInformationalMessages



Runs the command DBCC DROPCLEANBUFFERS WITH NO_INFOMSGS against the instance SqlServer2017 using Windows

Authentication

-------------------------- EXAMPLE 3 --------------------------



PS C:\\>'Sql1','Sql2/sqlexpress' | Invoke-DbaDbccDropCleanBuffer -WhatIf



Displays what will happen if command DBCC DROPCLEANBUFFERS is called against Sql1 and Sql2/sqlexpress

-------------------------- EXAMPLE 4 --------------------------



PS C:\\>$cred = Get-Credential sqladmin



PS C:\\> Invoke-DbaDbccDropCleanBuffer -SqlInstance Server1 -SqlCredential $cred



Connects using sqladmin credential and executes command DBCC DROPCLEANBUFFERS for instance Server1



RELATED LINKS

https://dbatools.io/Invoke-DbaDbccDropCleanBuffer