Skip to content

Get‑SqlDscDatabase

dscbot edited this page Dec 5, 2025 · 2 revisions

SYNOPSIS

Get databases from a SQL Server Database Engine instance.

SYNTAX

Get-SqlDscDatabase [-ServerObject] <Server> [[-Name] <String>] [-Refresh] 
 [<CommonParameters>]

DESCRIPTION

This command gets one or more databases from a SQL Server Database Engine instance. If no name is specified, all databases are returned.

EXAMPLES

EXAMPLE 1

$serverObject = Connect-SqlDscDatabaseEngine -InstanceName 'MyInstance'
$serverObject | Get-SqlDscDatabase

Get all databases from the instance.

EXAMPLE 2

$serverObject = Connect-SqlDscDatabaseEngine -InstanceName 'MyInstance'
$serverObject | Get-SqlDscDatabase -Name 'MyDatabase'

Get the database named MyDatabase.

PARAMETERS

-Name

Specifies the name of the database to get. If not specified, all databases are returned.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Refresh

Specifies that the ServerObject's databases should be refreshed before trying to get the database object. This is helpful when databases could have been modified outside of the ServerObject, for example through T-SQL. But on instances with a large amount of databases it might be better to make sure the ServerObject is recent enough.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ServerObject

Specifies current server connection object.

Type: Server
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

Microsoft.SqlServer.Management.Smo.Server

Accepts input via the pipeline.

OUTPUTS

Microsoft.SqlServer.Management.Smo.Database[]

Returns one or more database objects from the SQL Server instance.

NOTES

RELATED LINKS

Home

Commands

Resources

Usage

Clone this wiki locally