functions/Get-DbaDetachedDatabaseInfo.ps1
|
Function Get-DbaDetachedDatabaseInfo { <# .SYNOPSIS Get detailed information about detached SQL Server database files. .DESCRIPTION This script gathers the following information from detached database files: database name, SQL Server version (compatibility level), collation, and file structure. "Data files" and "Log file" report the structure of the data and log files as they were when the database was detached. "Database version" is the comptability level. MDF files are most easily read by using a SQL Server to interpret them. Because of this, you must specify a SQL Server and the path must be relative to the SQL Server. .PARAMETER SqlInstance An online SQL Server is required to parse the information within the detached database file. Note that this script will not attach the file, it will simply use SQL Server to read its contents. .PARAMETER Path The path to the MDF file. This path must be readable by the SQL Server service account. Ideally, the MDF will be located on the SQL Server itself, or on a network share to which the SQL Server service account has access. .PARAMETER SqlCredential Allows you to login to servers using SQL Logins as opposed to Windows Auth/Integrated/Trusted. To use: $cred = Get-Credential, this pass this $cred to the SqlCredential parameter. Windows Authentication will be used if SqlCredential is not specified. SQL Server does not accept Windows credentials being passed as credentials. To connect as a different Windows user, run PowerShell as that user. .NOTES Tags: DisasterRecovery Author: Chrissy LeMaire (@cl), netnerds.net dbatools PowerShell module (https://dbatools.io, clemaire@gmail.com) Copyright (C) 2016 Chrissy LeMaire This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>. .LINK https://dbatools.io/Get-DbaDetachedDatabaseInfo .EXAMPLE Get-DbaDetachedDatabaseInfo -SqlInstance sql2016 -Path M:\Archive\mydb.mdf SQL Server is required to process offilne MDF files. The abvoe example reutrns information about the detached database file, M:\Archive\mydb.mdf. This path is relative to the SQL Server "sql2016". #> [CmdletBinding(DefaultParameterSetName = "Default")] Param ( [parameter(Mandatory = $true)] [Alias("ServerInstance", "SqlServer")] [DbaInstanceParameter]$SqlInstance, [parameter(Mandatory = $true)] [Alias("Mdf")] [string]$Path, [PSCredential]$SqlCredential ) BEGIN { Function Get-MdfFileInfo { $datafiles = New-Object System.Collections.Specialized.StringCollection $logfiles = New-Object System.Collections.Specialized.StringCollection $servername = $server.name $serviceaccount = $server.ServiceAccount $exists = Test-DbaSqlPath $server $Path if ($exists -eq $false) { throw "$servername cannot access the file $path. Does the file exist and does the service account ($serviceaccount) have accesss to the path?" } try { $detachedDatabaseInfo = $server.DetachedDatabaseInfo($path) $dbname = ($detachedDatabaseInfo | Where-Object { $_.Property -eq "Database name" }).Value $exactdbversion = ($detachedDatabaseInfo | Where-Object { $_.Property -eq "Database version" }).Value $collationid = ($detachedDatabaseInfo | Where-Object { $_.Property -eq "Collation" }).Value } catch { throw "$servername cannot read the file $path. Is the database detached?" } switch ($exactdbversion) { 852 { $dbversion = "SQL Server 2016" } 829 { $dbversion = "SQL Server 2016 Prerelease" } 782 { $dbversion = "SQL Server 2014" } 706 { $dbversion = "SQL Server 2012" } 684 { $dbversion = "SQL Server 2012 CTP1" } 661 { $dbversion = "SQL Server 2008 R2" } 660 { $dbversion = "SQL Server 2008 R2" } 655 { $dbversion = "SQL Server 2008 SP2+" } 612 { $dbversion = "SQL Server 2005" } 611 { $dbversion = "SQL Server 2005" } 539 { $dbversion = "SQL Server 2000" } 515 { $dbversion = "SQL Server 7.0" } 408 { $dbversion = "SQL Server 6.5" } default { $dbversion = "Unknown" } } $collationsql = "SELECT name FROM fn_helpcollations() where collationproperty(name, N'COLLATIONID') = $collationid" try { $dataset = $server.databases['master'].ExecuteWithResults($collationsql) $collation = "$($dataset.Tables[0].Rows[0].Item(0))" } catch { $collation = $collationid } if ($collation.length -eq 0) { $collation = $collationid } try { foreach ($file in $server.EnumDetachedDatabaseFiles($path)) { $datafiles += $file } foreach ($file in $server.EnumDetachedLogFiles($path)) { $logfiles += $file } } catch { throw "$servername unable to enumerate database or log structure information for $path" } $mdfinfo = [pscustomobject]@{ Name = $dbname Version = $dbversion ExactVersion = $exactdbversion Collation = $collation DataFiles = $datafiles LogFiles = $logfiles } return $mdfinfo } } PROCESS { $server = Connect-SqlInstance -SqlInstance $SqlInstance -SqlCredential $SqlCredential $mdfinfo = Get-MdfFileInfo $server $path } END { $server.ConnectionContext.Disconnect() return $mdfinfo } } |