使用PowerShell修改MS SQL Server Login的User Mapping：指定库与db_owner角色

我来帮你解决这个问题——在PowerShell里修改SQL Server登录的用户映射并分配db_owner角色，有两种常用的方案，我都给你详细说明：

这个模块是微软官方提供的SQL Server管理工具，语法更贴合PowerShell习惯，操作也更直观。

首先确保你已经安装了该模块（如果没装，以管理员身份运行PowerShell执行）：

Install-Module -Name SqlServer -Force -AllowClobber

接下来是完整的实现代码，我会逐行注释说明：

# 替换成你的实际配置参数
$serverInstance = "你的SQL实例名（比如localhost\SQLEXPRESS）"
$loginName = "要修改的登录名（比如SQLTestLogin）"
$targetDbName = "目标数据库名（比如TestDB）"

# 连接到目标SQL Server实例
$server = Get-SqlInstance -ServerInstance $serverInstance

# 获取要操作的登录对象
$login = Get-SqlLogin -ServerInstance $serverInstance -Name $loginName

# 获取目标数据库对象
$database = Get-SqlDatabase -ServerInstance $serverInstance -Name $targetDbName

# 检查数据库中是否已存在该登录对应的用户，不存在则创建
$dbUser = $database.Users | Where-Object { $_.Login -eq $loginName }
if (-not $dbUser) {
    $dbUser = New-SqlUser -Database $database -Login $loginName -Name $loginName
    Write-Host "已为登录 $loginName 在数据库 $targetDbName 中创建映射用户"
}

# 将用户添加到db_owner角色
$dbRole = $database.Roles | Where-Object { $_.Name -eq "db_owner" }
if ($dbRole -and $dbUser) {
    if ($dbRole.Members -notcontains $dbUser.Name) {
        $dbRole.AddMember($dbUser.Name)
        $database.Alter() # 提交更改到数据库
        Write-Host "已将用户 $($dbUser.Name) 添加到 $targetDbName 的db_owner角色"
    } else {
        Write-Host "用户 $($dbUser.Name) 已经是 $targetDbName 的db_owner角色成员"
    }
}

如果不想依赖SqlServer模块，也可以直接用原生T-SQL语句实现，通过PowerShell的Invoke-SqlCmd执行脚本：

# 替换成你的实际配置参数
$serverInstance = "你的SQL实例名"
$loginName = "要修改的登录名"
$targetDbName = "目标数据库名"

# 构建T-SQL脚本，包含用户创建和角色分配逻辑
$sqlScript = @"
USE [$targetDbName];
GO
-- 如果数据库用户不存在则创建
IF NOT EXISTS (SELECT * FROM sys.database_principals WHERE name = N'$loginName')
BEGIN
    CREATE USER [$loginName] FOR LOGIN [$loginName];
    PRINT '已创建数据库用户 $loginName';
END
GO
-- 将用户添加到db_owner角色
ALTER ROLE db_owner ADD MEMBER [$loginName];
PRINT '已将用户 $loginName 添加到db_owner角色';
GO
"@

# 执行T-SQL脚本
Invoke-SqlCmd -ServerInstance $serverInstance -Query $sqlScript

关键注意事项： #

• 运行PowerShell的账号需要具备足够的SQL Server权限：至少需要ALTER ANY LOGIN、ALTER ANY USER和ALTER ROLE权限，或者直接拥有sysadmin角色。
• 如果是Windows登录，登录名格式通常是DOMAIN\Username，注意在T-SQL中要用方括号包裹避免语法错误。
• 两种方案都内置了重复检查逻辑，避免因用户已存在或已在角色中而报错。

内容的提问来源于stack exchange，提问作者Lotzi11