Version 1.0.1

This commit is contained in:
Madzone
2026-08-11 16:16:03 +02:00
parent fc892a39f4
commit 7b489678d1
5 changed files with 563 additions and 18 deletions
+80 -2
View File
@@ -688,6 +688,83 @@ function Get-SQLDatabases {
"
}
############################################################
# 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
@@ -738,7 +815,7 @@ function Test-DatabaseExists {
return (
$null -ne $Result -and
$Result.Count -gt 0
@($Result).Count -gt 0
)
@@ -1021,7 +1098,7 @@ function Test-SQLLoginExists {
return (
$null -ne $Result -and
$Result.Count -gt 0
@($Result).Count -gt 0
)
@@ -1506,6 +1583,7 @@ Export-ModuleMember `
New-SQLConnectionString,
Test-SQLConnection,
Invoke-SQLQuery,
Initialize-VeeamSQLDatabase,
Get-SQLDatabases,
Test-DatabaseExists,
New-SQLDatabase,
@@ -63,6 +63,52 @@ function Test-RepositoryPath {
############################################################
# Resolve-RepositoryPath
############################################################
function Resolve-RepositoryPath {
param(
[Parameter(Mandatory)][string]$Path,
[AllowEmptyString()][string]$InstallationSource
)
if($Path -ne "Auto") {
$Root = [IO.Path]::GetPathRoot($Path)
if($env:OS -eq "Windows_NT" -and ![string]::IsNullOrWhiteSpace($Root)) {
$DriveId = $Root.TrimEnd('\')
$Drive = Get-CimInstance Win32_LogicalDisk -Filter "DeviceID = '$DriveId'" -ErrorAction SilentlyContinue
if($null -ne $Drive -and $Drive.DriveType -ne 3) {
throw "Repository-Pfad liegt nicht auf einer lokalen Festplatte: $Path"
}
}
return $Path
}
if($env:OS -ne "Windows_NT") {
throw "Automatische Repository-Laufwerkswahl wird nur unter Windows unterstützt."
}
$SourceRoot = [IO.Path]::GetPathRoot($InstallationSource)
$FixedDrives = @(
Get-CimInstance Win32_LogicalDisk -Filter "DriveType = 3" -ErrorAction Stop |
Where-Object {
[string]::IsNullOrWhiteSpace($SourceRoot) -or
$_.DeviceID -ne $SourceRoot.TrimEnd('\')
} |
Sort-Object FreeSpace -Descending
)
if($FixedDrives.Count -eq 0) {
throw "Keine lokale Festplatte für das Veeam-Repository gefunden."
}
return (Join-Path ("{0}\" -f $FixedDrives[0].DeviceID) "VeeamRepository")
}
############################################################
# New-RepositoryFolder
@@ -1371,6 +1417,7 @@ function Get-RepositoryModuleInformation {
Export-ModuleMember `
-Function `
Test-RepositoryPath,
Resolve-RepositoryPath,
New-RepositoryFolder,
Get-RepositoryInformation,
Test-RepositoryFreeSpace,
@@ -293,6 +293,266 @@ function Resolve-VeeamSourcePath {
############################################################
# Resolve-VeeamAnswerFile
############################################################
function Resolve-VeeamAnswerFile {
<#
.SYNOPSIS
Ermittelt die Antwortdatei lokal oder relativ zur Installationsquelle.
#>
param(
[AllowEmptyString()][string]$AnswerFile,
[Parameter(Mandatory)][string]$SourcePath,
[Parameter(Mandatory)][string]$LocalConfigPath,
[ValidateSet("MSSQL", "PostgreSQL")][string]$DatabaseEngine = "MSSQL",
[string]$SQLServer,
[string]$SQLInstance,
[string]$DatabaseName = "VeeamBackup"
)
if(![string]::IsNullOrWhiteSpace($AnswerFile)) {
if(!(Test-Path -LiteralPath $AnswerFile -PathType Leaf)) {
throw "Explizit angegebene Veeam-Antwortdatei nicht gefunden: $AnswerFile"
}
return (Resolve-Path -LiteralPath $AnswerFile).Path
}
$LocalAnswerFile = Join-Path $LocalConfigPath "VeeamAnswerFile.xml"
if(Test-Path -LiteralPath $LocalAnswerFile -PathType Leaf) {
[xml]$LocalXml = Get-Content -LiteralPath $LocalAnswerFile -Raw
$RequiredValues = @(
"ACCEPT_EULA",
"ACCEPT_LICENSING_POLICY",
"ACCEPT_THIRDPARTY_LICENSES",
"ACCEPT_REQUIRED_SOFTWARE"
)
$Configured = $true
foreach($RequiredValue in $RequiredValues) {
$Node = $LocalXml.SelectSingleNode("//property[@name='$RequiredValue']")
if($null -eq $Node -or $Node.value -ne "1") {
$Configured = $false
break
}
}
# Ohne benutzerdefinierte Dienstkonto-Felder verwendet Veeam den
# empfohlenen LocalSystem-Standard. Vorlagenwerte würden sonst als
# echte Anmeldedaten validiert und die Installation blockieren.
foreach($ServiceProperty in @("VBR_SERVICE_USER", "VBR_SERVICE_PASSWORD")) {
if($null -ne $LocalXml.SelectSingleNode("//property[@name='$ServiceProperty']")) {
$Configured = $false
}
}
$InstallNode = $LocalXml.SelectSingleNode("//property[@name='VBR_SQLSERVER_INSTALL']")
$ExpectedInstallValue = if($DatabaseEngine -eq "MSSQL") { "0" } else { "1" }
if($null -eq $InstallNode -or $InstallNode.value -ne $ExpectedInstallValue) {
$Configured = $false
}
if($DatabaseEngine -eq "MSSQL") {
$ExpectedSqlTarget = "{0}\{1}" -f $SQLServer, $SQLInstance
$EngineNode = $LocalXml.SelectSingleNode("//property[@name='VBR_SQLSERVER_ENGINE']")
$ServerNode = $LocalXml.SelectSingleNode("//property[@name='VBR_SQLSERVER_SERVER']")
$DatabaseNode = $LocalXml.SelectSingleNode("//property[@name='VBR_SQLSERVER_DATABASE']")
if(
$null -eq $EngineNode -or $EngineNode.value -ne "0" -or
$null -eq $ServerNode -or $ServerNode.value -ne $ExpectedSqlTarget -or
$null -eq $DatabaseNode -or $DatabaseNode.value -ne $DatabaseName
) {
$Configured = $false
}
}
if($Configured) {
return (Resolve-Path -LiteralPath $LocalAnswerFile).Path
}
return New-VeeamAnswerFileFromTemplate `
-TemplatePath $LocalAnswerFile `
-DestinationPath $LocalAnswerFile `
-DatabaseEngine $DatabaseEngine `
-SQLServer $SQLServer `
-SQLInstance $SQLInstance `
-DatabaseName $DatabaseName
}
$SourceRoot = $SourcePath
if(Test-Path -LiteralPath $SourcePath -PathType Leaf) {
$SourceRoot = Split-Path -Parent $SourcePath
}
$Candidates = @(
(Join-Path $SourceRoot "VeeamAnswerFile.xml"),
(Join-Path $SourceRoot "Setup\Silent\VeeamAnswerFile.xml"),
(Join-Path $SourceRoot "Setup\Silent\AnswerFiles\VBR\VbrAnswerFile_install.xml")
)
foreach($Candidate in $Candidates) {
if(Test-Path -LiteralPath $Candidate -PathType Leaf) {
if([IO.Path]::GetFileName($Candidate) -eq "VbrAnswerFile_install.xml") {
return New-VeeamAnswerFileFromTemplate `
-TemplatePath $Candidate `
-DestinationPath $LocalAnswerFile `
-DatabaseEngine $DatabaseEngine `
-SQLServer $SQLServer `
-SQLInstance $SQLInstance `
-DatabaseName $DatabaseName
}
return (Resolve-Path -LiteralPath $Candidate).Path
}
}
$DiscoveredTemplate = Get-ChildItem `
-LiteralPath $SourceRoot `
-Recurse `
-Filter "VbrAnswerFile_install.xml" `
-File `
-ErrorAction SilentlyContinue |
Select-Object -First 1
if($null -ne $DiscoveredTemplate) {
return New-VeeamAnswerFileFromTemplate `
-TemplatePath $DiscoveredTemplate.FullName `
-DestinationPath $LocalAnswerFile `
-DatabaseEngine $DatabaseEngine `
-SQLServer $SQLServer `
-SQLInstance $SQLInstance `
-DatabaseName $DatabaseName
}
throw "Keine Veeam-Antwortdatei gefunden. Erwartet: Config\VeeamAnswerFile.xml oder DVD-Vorlage VbrAnswerFile_install.xml."
}
############################################################
# New-VeeamAnswerFileFromTemplate
############################################################
function New-VeeamAnswerFileFromTemplate {
param(
[Parameter(Mandatory)][string]$TemplatePath,
[Parameter(Mandatory)][string]$DestinationPath,
[ValidateSet("MSSQL", "PostgreSQL")][string]$DatabaseEngine = "MSSQL",
[string]$SQLServer,
[string]$SQLInstance,
[string]$DatabaseName = "VeeamBackup"
)
if(!(Test-Path -LiteralPath $TemplatePath -PathType Leaf)) {
throw "Veeam-Antwortvorlage nicht gefunden: $TemplatePath"
}
Write-Host ""
Write-Host "Veeam-Lizenzzustimmungen werden in der Antwortdatei automatisch gesetzt." -ForegroundColor Cyan
$DestinationDirectory = Split-Path -Parent $DestinationPath
if(!(Test-Path -LiteralPath $DestinationDirectory -PathType Container)) {
New-Item -Path $DestinationDirectory -ItemType Directory -Force | Out-Null
}
$TemplateFullPath = [IO.Path]::GetFullPath($TemplatePath)
$DestinationFullPath = [IO.Path]::GetFullPath($DestinationPath)
if($TemplateFullPath -ne $DestinationFullPath) {
Copy-Item -LiteralPath $TemplatePath -Destination $DestinationPath -Force
}
# Beim Kopieren von DVD/ISO kann das ReadOnly-Attribut erhalten bleiben.
# Vor dem Speichern muss die lokale Antwortdatei beschreibbar sein.
$DestinationItem = Get-Item -LiteralPath $DestinationPath -ErrorAction Stop
if($DestinationItem.IsReadOnly) {
$DestinationItem.IsReadOnly = $false
}
[xml]$Xml = Get-Content -LiteralPath $DestinationPath -Raw
$Root = $Xml.unattendedInstallationConfiguration
if($null -eq $Root -or $Root.bundle -ne "Vbr" -or $Root.mode -ne "install") {
throw "Ungültige Veeam-VBR-Installationsvorlage: $TemplatePath"
}
$PropertiesNode = $Root.properties
if($null -eq $PropertiesNode) {
throw "Eigenschaftsblock fehlt in der Veeam-Antwortvorlage."
}
function Set-AnswerProperty {
param([string]$Name, [string]$Value)
$Node = $Xml.SelectSingleNode("//property[@name='$Name']")
if($null -eq $Node) {
$Node = $Xml.CreateElement("property")
$Node.SetAttribute("name", $Name)
$PropertiesNode.AppendChild($Node) | Out-Null
}
$Node.SetAttribute("value", $Value)
}
foreach($Agreement in @(
"ACCEPT_EULA",
"ACCEPT_LICENSING_POLICY",
"ACCEPT_THIRDPARTY_LICENSES",
"ACCEPT_REQUIRED_SOFTWARE"
)) {
Set-AnswerProperty -Name $Agreement -Value "1"
}
if($DatabaseEngine -eq "MSSQL") {
if([string]::IsNullOrWhiteSpace($SQLServer) -or [string]::IsNullOrWhiteSpace($SQLInstance)) {
throw "Für Microsoft SQL müssen Server und Instanz angegeben sein."
}
Set-AnswerProperty -Name "VBR_SQLSERVER_INSTALL" -Value "0"
Set-AnswerProperty -Name "VBR_SQLSERVER_ENGINE" -Value "0"
Set-AnswerProperty -Name "VBR_SQLSERVER_SERVER" -Value ("{0}\{1}" -f $SQLServer, $SQLInstance)
Set-AnswerProperty -Name "VBR_SQLSERVER_DATABASE" -Value $DatabaseName
Set-AnswerProperty -Name "VBR_SQLSERVER_AUTHENTICATION" -Value "0"
$UnusedProperties = @(
"VBR_SERVICE_USER",
"VBR_SERVICE_PASSWORD",
"VBR_SQLSERVER_USERNAME",
"VBR_SQLSERVER_PASSWORD"
)
}
else {
Set-AnswerProperty -Name "VBR_SQLSERVER_INSTALL" -Value "1"
Set-AnswerProperty -Name "VBR_SQLSERVER_DATABASE" -Value $DatabaseName
$UnusedProperties = @(
"VBR_SERVICE_USER",
"VBR_SERVICE_PASSWORD",
"VBR_SQLSERVER_ENGINE",
"VBR_SQLSERVER_SERVER",
"VBR_SQLSERVER_AUTHENTICATION",
"VBR_SQLSERVER_USERNAME",
"VBR_SQLSERVER_PASSWORD"
)
}
foreach($UnusedProperty in $UnusedProperties) {
$Node = $Xml.SelectSingleNode("//property[@name='$UnusedProperty']")
if($null -ne $Node) {
$Node.ParentNode.RemoveChild($Node) | Out-Null
}
}
$Xml.Save($DestinationPath)
Write-Host "Konfigurierte Antwortdatei erstellt: $DestinationPath" -ForegroundColor Green
return (Resolve-Path -LiteralPath $DestinationPath).Path
}
############################################################
# Test-VeeamSource
@@ -1179,6 +1439,17 @@ function Invoke-VeeamInstallation {
if([string]::IsNullOrWhiteSpace($LogFolder))
{
$LogFolder = "C:\ProgramData\VeeamInstaller\SetupLogs"
}
if(!(Test-Path -LiteralPath $LogFolder -PathType Container))
{
New-Item -Path $LogFolder -ItemType Directory -Force | Out-Null
}
$Arguments =
New-VeeamInstallParameter `
@@ -1215,6 +1486,12 @@ function Invoke-VeeamInstallation {
$Result
LogFolder =
$LogFolder
}
}
@@ -1465,6 +1742,8 @@ Export-ModuleMember `
Get-VeeamServices,
Get-VeeamSetupFile,
Resolve-VeeamSourcePath,
Resolve-VeeamAnswerFile,
New-VeeamAnswerFileFromTemplate,
Test-VeeamSource,
Get-VeeamRegistryInformation,
Get-VeeamVersion,