dbatools项目：使用PowerShell管理SQL Server实例认证模式

在SQL Server数据库管理中，实例的认证模式是一个关键的安全配置选项。dbatools作为一款强大的PowerShell模块，虽然提供了丰富的SQL Server管理功能，但当前版本中缺少直接修改实例认证模式的命令。本文将介绍如何通过自定义PowerShell函数来实现这一功能。

SQL Server认证模式概述

SQL Server支持两种主要的认证模式：

1. Windows认证模式(Integrated)：仅允许使用Windows账户登录
2. 混合认证模式(Mixed)：允许同时使用Windows账户和SQL Server账户登录

认证模式的选择直接影响数据库服务器的安全策略和用户访问方式。在生产环境中，管理员可能需要根据安全要求调整认证模式。

自定义PowerShell函数实现

以下是一个完整的PowerShell函数实现，可以添加到dbatools模块中使用：

function Set-DbaInstanceAuthenticationMode {
    [CmdletBinding(SupportsShouldProcess, ConfirmImpact='Medium')]
    Param (
        [Parameter(ValueFromPipeline)]
        [DbaInstanceParameter[]]$SqlInstance,

        [PSCredential]$SqlCredential,

        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [ValidateSet('Integrated','Mixed','Normal')]
        [string]$AuthenticationMode,

        [switch]$Restart,

        [switch]$EnableException
    )

    Process {
        foreach ($instance in $SqlInstance) {
            try {
                $server = Connect-DbaInstance -SqlInstance $instance -SqlCredential $SqlCredential
            } catch {
                Write-Warning "无法连接到实例 $instance"
                continue
            }
            
            if($server.Settings.LoginMode -ne $AuthenticationMode){
                if ($pscmdlet.ShouldProcess($server, "将认证模式从 $($server.Settings.LoginMode) 更改为 $AuthenticationMode")) {
                    try {
                        $server.Settings.LoginMode = [Microsoft.SqlServer.Management.SMO.ServerLoginMode] $AuthenticationMode
                        $server.Settings.Alter()

                        if($Restart){
                            Restart-DbaService -SqlInstance $instance
                        }
                    } catch {
                        Write-Warning "无法修改 $server 的认证模式"
                        continue
                    }
                }
            } else {
                Write-Verbose "跳过：认证模式已设置为 $AuthenticationMode"
            }
        }
    }
}

函数功能详解

参数说明

1. SqlInstance：指定要修改的SQL Server实例，支持多个实例
2. SqlCredential：连接SQL Server的凭据
3. AuthenticationMode：目标认证模式，支持以下值：
   • Integrated：Windows认证
   • Mixed：混合认证
   • Normal：传统SQL认证(不推荐)
4. Restart：是否在修改后自动重启服务使更改生效
5. EnableException：控制异常处理行为

使用示例

# 将单个实例改为混合认证模式并重启服务
Set-DbaInstanceAuthenticationMode -SqlInstance "server01.domain.local" -AuthenticationMode Mixed -Restart

# 修改多个实例的认证模式但不重启
$instances = "server01","server02","server03"
Set-DbaInstanceAuthenticationMode -SqlInstance $instances -AuthenticationMode Integrated

技术实现要点

1. 使用SMO(Server Management Objects)的ServerLoginMode枚举来设置认证模式
2. 通过Settings.Alter()方法将更改应用到SQL Server实例
3. 提供-WhatIf支持，可以预览将要执行的操作
4. 包含详细的错误处理和日志记录

注意事项

1. 修改认证模式通常需要重启SQL Server服务才能生效
2. 从Windows认证改为混合认证时，需要确保已设置强壮的sa密码
3. 在生产环境中执行前，建议先在测试环境验证
4. 该操作需要管理员权限

这个自定义函数填补了dbatools在SQL Server认证模式管理方面的空白，为数据库管理员提供了一个方便、安全的工具来管理实例认证配置。