使用 PowerShell Desired State Configuration 安装 SQL Server

项目
2025-01-02

你是否曾经历过下述情况：使用 SQL Server 安装界面时，只是选择相同的按钮，输入相同的信息，而没有多加考虑？虽然安装已完成，但却忘了在 sysadmin 角色中指定 DBA 组。然后，必须执行以下操作：

进入单用户模式。
添加适当的用户或组。
在多用户模式下重新启动 SQL Server。
测试。

更糟糕的是，现在你会对整个安装过程产生怀疑。你可能会问自己“我还忘记了什么？”。

请阅读 PowerShell Desired State Configuration (DSC)。通过使用 DSC，可以构建一个能在成百上千个服务器上重复使用的配置模板。根据构建，可能需要调整几个安装参数。但这并不是最重要的问题，因为你可以保持所有标准设置不变。这消除了忘记输入重要参数的可能性。

本文将使用 SqlServerDsc DSC 资源探索 Windows Server 2016 上 SQL Server 2017 独立实例的初始设置。预先了解一些有关 DSC 的知识大有好处，因为我们不会探索 DSC 的工作原理。

注意

本文引用了 PowerShell 5.1，它是随 Windows Server 2016、2019 和 2022 一起安装的 PowerShell 的默认版本。

本演练需要以下项：

运行 Windows Server 2016 的计算机。
SQL Server 2017 安装介质。
SqlServerDsc DSC 资源。

先决条件

在大多数情况下，DSC 用于处理先决条件要求。但是，出于本演示的目的，我们将手动处理先决条件。

安装 SqlServerDsc DSC 资源

可使用 Install-Module cmdlet 从 PowerShell 库下载 SqlServerDsc DSC 资源。

注意

安装模块时，需确保“以管理员身份”运行 PowerShell 。

Install-Module -Name SqlServerDsc

获取 SQL Server 2017 安装介质

将 SQL Server 2017 安装介质下载到服务器。我们已通过 Visual Studio 订阅下载 SQL Server 2017 Enterprise，并将 ISO 复制到 C:\en_sql_server_2017_enterprise_x64_dvd_11293666.iso。

现在必须将 ISO 提取到目录：

New-Item -Path C:\SQL2017 -ItemType Directory
$mountResult = Mount-DiskImage -ImagePath 'C:\en_sql_server_2017_enterprise_x64_dvd_11293666.iso' -PassThru
$volumeInfo = $mountResult | Get-Volume
$driveInfo = Get-PSDrive -Name $volumeInfo.DriveLetter
Copy-Item -Path ( Join-Path -Path $driveInfo.Root -ChildPath '*' ) -Destination C:\SQL2017\ -Recurse
Dismount-DiskImage -ImagePath 'C:\en_sql_server_2017_enterprise_x64_dvd_11293666.iso'

创建配置

配置

创建配置函数，将调用该函数生成托管对象格式 (MOF) 文档：

Configuration SQLInstall
{...}

模块

将模块导入当前会话。这些模块告知配置文档如何构建 MOF 文档。此外，它们还告知 DSC 引擎如何将 MOF 文档应用于服务器：

Import-DscResource -ModuleName SqlServerDsc

资源

.NET Framework

SQL Server 依赖于 .NET Framework。因此我们需要确保在安装 SQL Server 前安装它。 WindowsFeature 资源用于安装 Net-Framework-45-Core Windows 功能：

WindowsFeature 'NetFramework45'
{
     Name = 'Net-Framework-45-Core'
     Ensure = 'Present'
}

SqlSetup

SqlSetup 资源用于告知 DSC 如何安装 SQL Server 。基本安装所需的参数如下所示：

InstanceName 。实例的名称。使用 MSSQLSERVER 作为默认实例。
Features。要安装的功能。在此示例中，我们仅安装 SQLEngine 功能。
SourcePath。 SQL 安装介质的路径。在此示例中，我们将 SQL 安装介质存储在 C:\SQL2017 中。网络共享可最大程度减少服务器上使用的空间。
SQLSysAdminAccounts。要成为 sysadmin 角色成员的用户或组。在此示例中，我们授予本地管理员组 sysadmin 访问权限。

注意

不建议在高安全性环境中使用此配置。

有关 SqlSetup 上可用参数的完整列表和说明，请参阅 SqlServerDsc GitHub 存储库。

SqlSetup 资源仅安装 SQL Server，但不维护所应用的设置。例如在安装时指定 SQLSysAdminAccounts 的情况。管理员可以在 sysadmin 角色中添加或删除登录。但 SqlSetup 资源不会受到影响。如果希望 DSC 强制执行 sysadmin 角色的成员身份，请使用 SqlServerRole 资源。

完成配置

Configuration SQLInstall
{
     Import-DscResource -ModuleName SqlServerDsc

     node localhost
     {
          WindowsFeature 'NetFramework45'
          {
               Name   = 'NET-Framework-45-Core'
               Ensure = 'Present'
          }

          SqlSetup 'InstallDefaultInstance'
          {
               InstanceName        = 'MSSQLSERVER'
               Features            = 'SQLENGINE'
               SourcePath          = 'C:\SQL2017'
               SQLSysAdminAccounts = @('Administrators')
               DependsOn           = '[WindowsFeature]NetFramework45'
          }
     }
}

生成并部署

编译配置

在配置脚本中添加圆点：

. .\SQLInstallConfiguration.ps1

运行配置函数：

SQLInstall

在工作目录中创建一个名为 SQLInstall 的目录。该目录包含一个名为 localhost.mof 的文件。检查显示已编译的 DSC 配置的 MOF 的内容。

部署配置

若要启动 SQL Server 的 DSC 部署，请调用 Start-DscConfiguration cmdlet 。为 cmdlet 提供了以下参数：

Path。包含要部署的 MOF 文档的文件夹的路径。示例为 C:\SQLInstall。
Wait。等待配置作业完成。
Force。替代任何现有 DSC 配置。
Verbose。显示详细输出。首次推送配置时非常有用，可帮助排除故障。

Start-DscConfiguration -Path C:\SQLInstall -Wait -Force -Verbose

随着配置的应用，详细输出将显示所发生的情况。只要没有引发任何错误（红色文本），那么当屏幕上出现“操作‘调用 CimMethod’完成”时，应安装 SQL Server 。

验证安装

DSC

Test-DscConfiguration cmdlet 可以确定服务器的当前状态是否符合所需状态。在此情况下，状态为 SQL Server 安装。 Test-DscConfiguration 的结果应为“True” ：

PS C:\> Test-DscConfiguration
True

服务

现在服务列表返回 SQL Server 服务：

PS C:\> Get-Service -Name *SQL*
Status  Name           DisplayName
------  ----           -----------
Running MSSQLSERVER    SQL Server (MSSQLSERVER)
Stopped SQLBrowser     SQL Server Browser
Running SQLSERVERAGENT SQL Server Agent (MSSQLSERVER)
Running SQLTELEMETRY   SQL Server CEIP service (MSSQLSERVER)
Running SQLWriter      SQL Server VSS Writer

SQL Server

PS C:\> & sqlcmd -S $env:COMPUTERNAME
1> SELECT @@SERVERNAME
2> GO
1> quit

另请参阅

Windows PowerShell Desired State Configuration 概述

从命令提示符安装 SQL Server

使用配置文件安装 SQL Server

通过