commands

^

Get-DbaFeature

Author Chrissy LeMaire (@cl), netnerds.net
Availability Windows, Linux, macOS

 

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

Synopsis

Runs the SQL Server feature discovery report (setup.exe /Action=RunDiscovery)

Description

Runs the SQL Server feature discovery report (setup.exe /Action=RunDiscovery)

Inspired by Dave Mason's (@BeginTry) post at
https://itsalljustelectrons.blogspot.be/2018/04/SQL-Server-Discovery-Report.html

Assumptions:

  1. The sub-folder "Microsoft SQL Server" exists in [System.Environment]::GetFolderPath("ProgramFiles"),
    even if SQL was installed to a non-default path. This has been
    verified on SQL 2008R2 and SQL 2012. Further verification may be needed.
  2. The discovery report displays installed components for the version of SQL
    Server associated with setup.exe, along with installed components of all
    lesser versions of SQL Server that are installed.

Syntax

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

 

Examples

 

Example: 1
PS C:\> Get-DbaFeature -ComputerName sql2017, sql2016, sql2005

Gets all SQL Server features for all instances on sql2017, sql2016 and sql2005.

Example: 2
PS C:\> Get-DbaFeature -Verbose

Gets all SQL Server features for all instances on localhost. Outputs to screen if no instances are found.

Example: 3
PS C:\> Get-DbaFeature -ComputerName sql2017 -Credential ad\sqldba

Gets all SQL Server features for all instances on sql2017 using the ad\sqladmin credential (which has access to the Windows Server).

Optional Parameters

-ComputerName

The target computer. If the target is not localhost, it must have PowerShell remoting enabled.
Note that this is not the SqlInstance, but rather the ComputerName

Alias
Required False
Pipeline true (ByValue)
Default Value $env:COMPUTERNAME
-Credential

Allows you to login to servers using alternative credentials. To use:
$cred = Get-Credential, then pass $cred object to the -Credential parameter.

Alias
Required False
Pipeline false
Default Value
-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.

Alias
Required False
Pipeline false
Default Value False