PowerShell Splatting语法及用户创建脚本哈希表变量读取问题

一、Splatting 的正确语法 #

Splatting 是 PowerShell 里简化参数传递的实用技巧，主要有两种常用形式：

1. 哈希表形式（针对命名参数） #

适用于需要明确指定参数名的场景，哈希表的键是参数名称，值是对应的参数值，调用命令时用 @ 符号代替 $ 来引用哈希表：

# 定义包含参数的哈希表
$adUserParams = @{
    GivenName = "Alice"
    Surname   = "Smith"
    Path      = "OU=Employees,DC=company,DC=local"
    Enabled   = $true
}

# 使用 Splatting 调用命令
New-ADUser @adUserParams

2. 数组形式（针对位置参数） #

如果命令的参数是按位置传递的，可以用数组存储参数值，同样用 @ 符号引用：

# 数组按顺序存储位置参数的值
$adUserArgs = @("Bob", "Jones", "OU=Employees,DC=company,DC=local")

# 假设 New-ADUser 前三个位置参数对应 GivenName、Surname、Path
New-ADUser @adUserArgs

二、解决脚本中的用户 Name 属性问题 #

针对你的脚本问题，核心是动态拼接 Name 属性并确保 CSV 文件的表头正确，具体步骤如下：

1. 确保 CSV 文件的表头正确 #

你的 CSV 文件第一行必须包含 GivenName 和 Surname 表头，示例内容如下：

GivenName,Surname,SamAccountName
John,Doe,jdoe
Jane,Smith,jsmith

这样 Import-Csv 读取后，每个用户对象都会有 .GivenName 和 .Surname 属性。

2. 修改脚本动态生成 Name 属性 #

在循环处理每个用户时，构建 Splatting 哈希表，把 Name 属性设置为 GivenName + Surname 的拼接值，修改后的脚本片段如下：

cls
# 获取CSV文件（确保表头包含GivenName、Surname）
$userList = Import-Csv "C:\users.csv"

# 预设用户密码（根据实际需求调整）
$securePassword = ConvertTo-SecureString "YourStrongPassword123!" -AsPlainText -Force

# 循环处理每个用户
foreach ($user in $userList) {
    # 构建Splatting哈希表，动态生成Name属性
    $userParams = @{
        GivenName       = $user.GivenName
        Surname         = $user.Surname
        Name            = "$($user.GivenName) $($user.Surname)"  # 拼接姓名作为Name
        SamAccountName  = $user.SamAccountName  # 从CSV读取或自行生成
        AccountPassword = $securePassword
        Enabled         = $true
        Path            = "OU=Users,DC=yourdomain,DC=com"  # 替换为你的OU路径
    }

    # 使用Splatting创建AD用户
    New-ADUser @userParams
}

关键说明： #

• 用 $() 包裹变量（$($user.GivenName)）是为了确保在字符串中正确解析对象属性，避免拼接错误。
• 如果CSV里没有 SamAccountName，你也可以动态生成，比如 $($user.GivenName.Substring(0,1))$($user.Surname)（取名字首字母+姓氏）。

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