如何修改Active Directory的PowerShell代码以处理CSV空值单元格

你的问题核心在于：当CSV中的字段为空时，Set-ADUser会尝试将对应的AD属性设置为空字符串，但Active Directory的多数属性不接受空值传递，直接触发命令失败。解决的关键是只在CSV字段有有效内容时，才传递对应的参数给Set-ADUser，避免空值干扰。

下面提供两种实用的解决方案：

方案一：逐个字段判断（直观易读） #

这种方式适合字段数量不多的场景，逐个检查每个CSV字段的值，仅当非空时添加到参数列表：

Import-Csv "C:\jo.csv" -Delimiter ';' | ForEach-Object {
    # 初始化参数哈希表，必须包含Identity参数
    $adUserParams = @{
        Identity = $_.SamAccountName
    }

    # 检查并添加非空字段到参数
    if (-not [string]::IsNullOrWhiteSpace($_.surname)) {
        $adUserParams['Surname'] = $_.surname
    }
    if (-not [string]::IsNullOrWhiteSpace($_.givenname)) {
        $adUserParams['Givenname'] = $_.givenname
    }
    if (-not [string]::IsNullOrWhiteSpace($_.displayname)) {
        $adUserParams['Displayname'] = $_.displayname
    }
    if (-not [string]::IsNullOrWhiteSpace($_.Title)) {
        $adUserParams['Title'] = $_.Title
    }
    if (-not [string]::IsNullOrWhiteSpace($_.Department)) {
        $adUserParams['Department'] = $_.Department
    }
    if (-not [string]::IsNullOrWhiteSpace($_.Manager)) {
        $adUserParams['Manager'] = $_.Manager
    }
    # 注意：原代码中OfficePhone映射的是HomePhone，确认是否是预期的字段映射
    if (-not [string]::IsNullOrWhiteSpace($_.HomePhone)) {
        $adUserParams['OfficePhone'] = $_.HomePhone
    }
    if (-not [string]::IsNullOrWhiteSpace($_.MobilePhone)) {
        $adUserParams['MobilePhone'] = $_.MobilePhone
    }

    # 使用Splatting传递参数，只设置有值的属性
    Set-ADUser @adUserParams
}

方案二：映射表批量处理（简洁易维护） #

如果需要处理的字段较多，用映射表来关联CSV字段和AD属性名，批量遍历检查，代码更整洁：

# 定义CSV字段到AD属性的映射关系，按需调整
$propertyMap = @{
    'surname'      = 'Surname'
    'givenname'    = 'Givenname'
    'displayname'  = 'Displayname'
    'Title'        = 'Title'
    'Department'   = 'Department'
    'Manager'      = 'Manager'
    'HomePhone'    = 'OfficePhone' # 确认字段映射是否正确
    'MobilePhone'  = 'MobilePhone'
}

Import-Csv "C:\jo.csv" -Delimiter ';' | ForEach-Object {
    $adUserParams = @{ Identity = $_.SamAccountName }

    # 遍历映射表，批量添加非空参数
    foreach ($csvField in $propertyMap.Keys) {
        $fieldValue = $_.$csvField
        if (-not [string]::IsNullOrWhiteSpace($fieldValue)) {
            $adUserParams[$propertyMap[$csvField]] = $fieldValue
        }
    }

    Set-ADUser @adUserParams
}

额外说明 #

• [string]::IsNullOrWhiteSpace()是判断空值的最优方式，它会同时过滤null、空字符串''和全空白字符（比如空格、制表符），比简单的$value -ne ''更全面。
• 如果需要主动清空某个AD属性（比如把用户的MobilePhone设置为空），可以在CSV中用特定标记（比如CLEAR），然后在代码中单独处理：

  # 以MobilePhone为例
  if ($_.MobilePhone -eq 'CLEAR') {
      # 方式1：传递$null清空属性
      $adUserParams['MobilePhone'] = $null
      # 方式2：使用-Clear参数（更推荐，符合AD规范）
      # $adUserParams['Clear'] = 'MobilePhone'
  } elseif (-not [string]::IsNullOrWhiteSpace($_.MobilePhone)) {
      $adUserParams['MobilePhone'] = $_.MobilePhone
  }
  

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