<# --------------------------------------------------------------------------- Module......: SQL.psm1 Projekt.....: Veeam Enterprise Installer Version.....: 2.0.0 Beschreibung SQL Verwaltung für Veeam Installation. Unterstützt: • SQL Instanzprüfung • SQL Verbindung • Serviceprüfung • Datenbankprüfung • Benutzerprüfung • Datenbankbereitstellung Zielumgebung: SQL Server 2022 Standard Instanz VEEAMSQLSERVER ---------------------------------------------------------------------------#> Set-StrictMode -Version Latest #region Variablen $Script:SQLVersion = "2.0.0" $Script:DefaultInstance = "VEEAMSQLSERVER" #endregion ############################################################ # Get-SQLServiceName ############################################################ function Get-SQLServiceName { <# .SYNOPSIS Ermittelt SQL Dienstnamen. #> param( [string]$Instance = $Script:DefaultInstance ) if($Instance -eq "MSSQLSERVER") { return "MSSQLSERVER" } return "MSSQL`$$Instance" } ############################################################ # Get-SQLService ############################################################ function Get-SQLService { <# .SYNOPSIS Liefert SQL Dienst. #> param( [string]$Instance = $Script:DefaultInstance ) $ServiceName = Get-SQLServiceName ` -Instance $Instance try { Get-Service ` -Name $ServiceName ` -ErrorAction Stop } catch { return $null } } ############################################################ # Test-SQLService ############################################################ function Test-SQLService { <# .SYNOPSIS Prüft SQL Dienst. #> param( [string]$Instance = $Script:DefaultInstance ) $Service = Get-SQLService ` -Instance $Instance if($null -eq $Service) { return $false } return ( $Service.Status -eq "Running" ) } #Beginn PART 2 ############################################################ # Get-SQLInstances ############################################################ function Get-SQLInstances { <# .SYNOPSIS Listet SQL Instanzen auf dem Server. #> $RegistryPaths = @( "HKLM:\SOFTWARE\Microsoft\Microsoft SQL Server\Instance Names\SQL", "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server\Instance Names\SQL" ) $Instances = @() foreach($Path in $RegistryPaths) { if(Test-Path $Path) { $Data = Get-ItemProperty ` -Path $Path foreach($Property in $Data.PSObject.Properties) { if( $Property.Name ` -notmatch "^PS" ) { $Instances += [PSCustomObject]@{ Name = $Property.Name InstanceID = $Property.Value } } } } } return $Instances } ############################################################ # Test-SQLInstanceExists ############################################################ function Test-SQLInstanceExists { param( [string]$Instance = $Script:DefaultInstance ) $Instances = Get-SQLInstances foreach($Item in $Instances) { if( $Item.Name ` -eq $Instance ) { return $true } } return $false } ############################################################ # Get-SQLVersion ############################################################ function Get-SQLVersion { <# .SYNOPSIS Liest SQL Server Version. #> param( [string]$Instance = $Script:DefaultInstance ) $Target = Get-SQLInstances | Where-Object { $_.Name -eq $Instance } | Select-Object -First 1 if($null -eq $Target) { return $null } $SetupPaths = @( "HKLM:\SOFTWARE\Microsoft\Microsoft SQL Server\$($Target.InstanceID)\Setup" "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server\$($Target.InstanceID)\Setup" ) foreach($SetupPath in $SetupPaths) { if(Test-Path $SetupPath) { $Setup = Get-ItemProperty -Path $SetupPath $VersionProperty = $Setup.PSObject.Properties["Version"] if($null -ne $VersionProperty) { return $VersionProperty.Value } } } return $null } ############################################################ # Get-SQLPort ############################################################ function Get-SQLPort { <# .SYNOPSIS Liest TCP Port der Instanz. #> param( [string]$Instance = $Script:DefaultInstance ) $Instances = Get-SQLInstances $Target = $Instances | Where-Object { $_.Name -eq $Instance } if($null -eq $Target) { return $null } $PortPath = "HKLM:\SOFTWARE\Microsoft\Microsoft SQL Server\$($Target.InstanceID)\MSSQLServer\SuperSocketNetLib\Tcp\IPAll" if(Test-Path $PortPath) { Get-ItemProperty ` $PortPath | Select-Object ` TcpPort, TcpDynamicPorts } } #Beginn PART 3 ############################################################ # New-SQLConnectionString ############################################################ function New-SQLConnectionString { <# .SYNOPSIS Erstellt SQL Connection String. #> param( [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance, [string]$Database = "master", [ValidateRange(1, 300)] [int]$ConnectionTimeout = 15 ) $DataSource = $Server if( ![string]::IsNullOrWhiteSpace($Instance) -and $Instance -ne "MSSQLSERVER" ) { $DataSource = "$Server\$Instance" } $Builder = New-Object ` System.Data.SqlClient.SqlConnectionStringBuilder $Builder["Data Source"] = $DataSource $Builder["Initial Catalog"] = $Database $Builder["Integrated Security"] = $true $Builder["TrustServerCertificate"] = $true $Builder["Connect Timeout"] = $ConnectionTimeout return $Builder.ConnectionString } ############################################################ # Test-SQLConnection ############################################################ function Test-SQLConnection { <# .SYNOPSIS Prüft SQL Verbindung. #> param( [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance ) $Connection = $null $ConnectionString = New-SQLConnectionString ` -Server $Server ` -Instance $Instance try { $Connection = New-Object ` System.Data.SqlClient.SqlConnection( $ConnectionString ) $Connection.Open() return $true } catch { return $false } finally { if($null -ne $Connection) { $Connection.Dispose() } } } ############################################################ # Invoke-SQLQuery ############################################################ function Invoke-SQLQuery { <# .SYNOPSIS Führt SQL Query aus. #> param( [Parameter(Mandatory)] [string]$Query, [string]$Database = "master", [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance, [hashtable]$Parameters = @{}, [ValidateRange(1, 3600)] [int]$CommandTimeout = 30 ) $ConnectionString = New-SQLConnectionString ` -Server $Server ` -Instance $Instance ` -Database $Database $Connection = New-Object ` System.Data.SqlClient.SqlConnection( $ConnectionString ) $Command = $Connection.CreateCommand() $Command.CommandText = $Query $Command.CommandTimeout = $CommandTimeout foreach($Name in $Parameters.Keys) { $ParameterName = if($Name -like "@*") { $Name } else { "@$Name" } $ParameterValue = $Parameters[$Name] if($null -eq $ParameterValue) { $ParameterValue = [DBNull]::Value } $Command.Parameters.AddWithValue( $ParameterName, $ParameterValue ) | Out-Null } $Adapter = $null try { $Connection.Open() $Adapter = New-Object ` System.Data.SqlClient.SqlDataAdapter( $Command ) $Table = New-Object ` System.Data.DataTable $Adapter.Fill($Table) | Out-Null return $Table } finally { if($null -ne $Adapter) { $Adapter.Dispose() } $Command.Dispose() $Connection.Dispose() } } ############################################################ # Get-SQLDatabases ############################################################ function Get-SQLDatabases { <# .SYNOPSIS Listet Datenbanken. #> Invoke-SQLQuery ` -Query " SELECT name, database_id, state_desc FROM sys.databases ORDER BY name " } ############################################################ # Initialize-VeeamSQLDatabase ############################################################ function Initialize-VeeamSQLDatabase { <# .SYNOPSIS Legt die Veeam-Konfigurationsdatenbank vorab an und berechtigt das standardmäßige Veeam-Dienstkonto LocalSystem als db_owner. #> param( [Parameter(Mandatory)][string]$Server, [Parameter(Mandatory)][string]$Instance, [Parameter(Mandatory)][string]$Database ) if($Database -notmatch '^[A-Za-z0-9_]+$') { throw "Ungültiger SQL-Datenbankname: $Database" } # Das integrierte LocalSystem-Konto ist sprachabhängig benannt # (z. B. NT-AUTORITÄT\SYSTEM auf einem deutschen Windows). Die SID ist # dagegen auf allen unterstützten Windows-Systemen identisch. $LocalSystemSid = New-Object System.Security.Principal.SecurityIdentifier("S-1-5-18") $LocalSystemAccount = $LocalSystemSid.Translate([System.Security.Principal.NTAccount]).Value $AccountLiteral = $LocalSystemAccount.Replace("'", "''") $AccountIdentifier = $LocalSystemAccount.Replace("]", "]]" ) $CreateDatabaseQuery = @" IF SUSER_ID(N'$AccountLiteral') IS NULL BEGIN CREATE LOGIN [$AccountIdentifier] FROM WINDOWS; END; IF DB_ID(@DatabaseName) IS NULL BEGIN CREATE DATABASE [$Database]; END; "@ Invoke-SQLQuery ` -Server $Server ` -Instance $Instance ` -Database "master" ` -Query $CreateDatabaseQuery ` -Parameters @{ DatabaseName = $Database } | Out-Null $GrantDatabaseQuery = @" IF DATABASE_PRINCIPAL_ID(N'$AccountLiteral') IS NULL BEGIN CREATE USER [$AccountIdentifier] FOR LOGIN [$AccountIdentifier]; END; IF IS_ROLEMEMBER(N'db_owner', N'$AccountLiteral') <> 1 BEGIN ALTER ROLE [db_owner] ADD MEMBER [$AccountIdentifier]; END; "@ Invoke-SQLQuery ` -Server $Server ` -Instance $Instance ` -Database $Database ` -Query $GrantDatabaseQuery | Out-Null return [PSCustomObject]@{ Server = $Server Instance = $Instance Database = $Database ServiceAccount = $LocalSystemAccount DatabaseRole = "db_owner" Prepared = $true } } #Beginn PART 4 ############################################################ # Test-DatabaseExists ############################################################ function Test-DatabaseExists { <# .SYNOPSIS Prüft ob Datenbank existiert. #> param( [Parameter(Mandatory)] [string]$DatabaseName, [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance ) $Result = Invoke-SQLQuery ` -Server $Server ` -Instance $Instance ` -Parameters @{ DatabaseName = $DatabaseName } ` -Query " SELECT name FROM sys.databases WHERE name = @DatabaseName " return ( $null -ne $Result -and @($Result).Count -gt 0 ) } ############################################################ # New-SQLDatabase ############################################################ function New-SQLDatabase { <# .SYNOPSIS Erstellt SQL Datenbank. #> param( [Parameter(Mandatory)] [string]$DatabaseName ) if($DatabaseName -notmatch '^[A-Za-z0-9_]+$') { throw "Ungültiger Datenbankname: $DatabaseName" } if(Test-DatabaseExists -DatabaseName $DatabaseName) { return $false } Invoke-SQLQuery ` -Query " CREATE DATABASE [$DatabaseName] " | Out-Null return ( Test-DatabaseExists ` -DatabaseName $DatabaseName ) } ############################################################ # Remove-SQLDatabase ############################################################ function Remove-SQLDatabase { <# .SYNOPSIS Löscht SQL Datenbank. Nur für Wartung/Test. #> param( [Parameter(Mandatory)] [string]$DatabaseName ) if($DatabaseName -notmatch '^[A-Za-z0-9_]+$') { throw "Ungültiger Datenbankname: $DatabaseName" } if(!(Test-DatabaseExists -DatabaseName $DatabaseName)) { return $false } Invoke-SQLQuery ` -Query " ALTER DATABASE [$DatabaseName] SET SINGLE_USER WITH ROLLBACK IMMEDIATE; DROP DATABASE [$DatabaseName]; " | Out-Null return $true } ############################################################ # Get-DatabaseCollation ############################################################ function Get-DatabaseCollation { <# .SYNOPSIS Liest Datenbank Collation. #> param( [Parameter(Mandatory)] [string]$DatabaseName, [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance ) $Result = Invoke-SQLQuery ` -Database $DatabaseName ` -Server $Server ` -Instance $Instance ` -Query " SELECT DATABASEPROPERTYEX( DB_NAME(), 'Collation' ) AS Collation " return $Result.Collation } ############################################################ # Test-VeeamDatabase ############################################################ function Test-VeeamDatabase { <# .SYNOPSIS Prüft Veeam Datenbank. #> param( [string]$DatabaseName = "VeeamBackup", [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance ) [PSCustomObject]@{ Name = $DatabaseName Exists = Test-DatabaseExists ` -DatabaseName $DatabaseName ` -Server $Server ` -Instance $Instance Collation = if( Test-DatabaseExists ` -DatabaseName $DatabaseName ` -Server $Server ` -Instance $Instance ) { Get-DatabaseCollation ` -DatabaseName $DatabaseName ` -Server $Server ` -Instance $Instance } else { $null } } } #Beginn PART 5 ############################################################ # Test-SQLLoginExists ############################################################ function Test-SQLLoginExists { <# .SYNOPSIS Prüft SQL Login. #> param( [Parameter(Mandatory)] [string]$LoginName ) $Result = Invoke-SQLQuery ` -Parameters @{ LoginName = $LoginName } ` -Query " SELECT name FROM sys.server_principals WHERE name = @LoginName " return ( $null -ne $Result -and @($Result).Count -gt 0 ) } ############################################################ # Get-SQLLogin ############################################################ function Get-SQLLogin { param( [Parameter(Mandatory)] [string]$LoginName ) Invoke-SQLQuery ` -Parameters @{ LoginName = $LoginName } ` -Query " SELECT name, type_desc, create_date FROM sys.server_principals WHERE name = @LoginName " } ############################################################ # Test-DatabasePermission ############################################################ function Test-DatabasePermission { <# .SYNOPSIS Prüft Datenbankrechte. #> param( [Parameter(Mandatory)] [string]$DatabaseName, [Parameter(Mandatory)] [string]$UserName ) $Result = Invoke-SQLQuery ` -Database $DatabaseName ` -Parameters @{ UserName = $UserName } ` -Query " SELECT dp.name, dp.type_desc FROM sys.database_principals dp WHERE dp.name = @UserName " return $Result } ############################################################ # Get-SQLConfigurationReport ############################################################ function Get-SQLConfigurationReport { <# .SYNOPSIS Erstellt SQL Bericht. #> [PSCustomObject]@{ Computer = $env:COMPUTERNAME Instance = $Script:DefaultInstance ServiceRunning = Test-SQLService Connection = Test-SQLConnection Databases = Get-SQLDatabases Timestamp = Get-Date } } ############################################################ # Test-VeeamSQLPreparation ############################################################ function Test-VeeamSQLPreparation { <# .SYNOPSIS Komplette SQL Vorbereitung. #> $Report = [ordered]@{} $Report.Instance = Test-SQLInstanceExists $Report.Service = Test-SQLService $Report.Connection = Test-SQLConnection $Report.Database = Test-VeeamDatabase return ( [PSCustomObject]$Report ) } #Beginn PART 6 ############################################################ # Get-SQLServerInformation ############################################################ function Get-SQLServerInformation { <# .SYNOPSIS Liefert SQL Server Informationen. #> param( [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance ) $Result = Invoke-SQLQuery ` -Server $Server ` -Instance $Instance ` -Query " SELECT SERVERPROPERTY( 'ServerName' ) AS ServerName, SERVERPROPERTY( 'ProductVersion' ) AS ProductVersion, SERVERPROPERTY( 'ProductLevel' ) AS ProductLevel, SERVERPROPERTY( 'Edition' ) AS Edition " return $Result } ############################################################ # Test-SQLVersionSupported ############################################################ function Test-SQLVersionSupported { <# .SYNOPSIS Prüft SQL Version. Ziel: SQL Server 2022 #> param( [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance ) $Info = Get-SQLServerInformation ` -Server $Server ` -Instance $Instance if($null -eq $Info) { return $false } return ( $Info.ProductVersion ` -like "16.*" ) } ############################################################ # Get-SQLEdition ############################################################ function Get-SQLEdition { param( [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance ) $Info = Get-SQLServerInformation ` -Server $Server ` -Instance $Instance if($null -eq $Info) { return $null } return $Info.Edition } ############################################################ # Test-SQLConfiguration ############################################################ function Test-SQLConfiguration { <# .SYNOPSIS Gesamte SQL Prüfung. #> param( [string]$Server = $env:COMPUTERNAME, [string]$Instance = $Script:DefaultInstance, [string]$Database = "VeeamBackup" ) [PSCustomObject]@{ Instance = $Instance Service = Test-SQLService ` -Instance $Instance Connection = Test-SQLConnection ` -Server $Server ` -Instance $Instance VersionSupported = Test-SQLVersionSupported ` -Server $Server ` -Instance $Instance Edition = Get-SQLEdition ` -Server $Server ` -Instance $Instance Database = Test-VeeamDatabase ` -DatabaseName $Database ` -Server $Server ` -Instance $Instance Time = Get-Date } } ############################################################ # Get-SQLModuleInformation ############################################################ function Get-SQLModuleInformation { [PSCustomObject]@{ Module = "SQL.psm1" Version = $Script:SQLVersion DefaultInstance = $Script:DefaultInstance Loaded = $true } } #Beginn PART 7 ############################################################ # Export Module Functions ############################################################ Export-ModuleMember ` -Function ` Get-SQLServiceName, Get-SQLService, Test-SQLService, Get-SQLInstances, Test-SQLInstanceExists, Get-SQLVersion, Get-SQLPort, New-SQLConnectionString, Test-SQLConnection, Invoke-SQLQuery, Initialize-VeeamSQLDatabase, Get-SQLDatabases, Test-DatabaseExists, New-SQLDatabase, Remove-SQLDatabase, Get-DatabaseCollation, Test-VeeamDatabase, Test-SQLLoginExists, Get-SQLLogin, Test-DatabasePermission, Get-SQLConfigurationReport, Test-VeeamSQLPreparation, Get-SQLServerInformation, Test-SQLVersionSupported, Get-SQLEdition, Test-SQLConfiguration, Get-SQLModuleInformation ############################################################ # Ende SQL.psm1 ############################################################