Import-CSV：使用 PowerShell 读取 CSV 文件

您可以使用 Import-CSV PowerShell cmdlet 读取 CSV 文件的内容。加载 CSV 文件的内容后，您将获得一个 PowerShell 对象，其中 CSV 文件中的每一列都是一个单独的属性。本文讨论使用 Import-CSV cmdlet 从 CSV 文件读取数据的具体细节。

CSV 文件用于存储表格数据。例如，我们创建了一个简单的 Excel 电子表格，其中包含 AD 用户信息，其结构如下：

ADlogin

,

Email

,

Phone

,

Department

。请注意，电子表格的第一行包含列名称。在 PowerShell 中，这些将作为数组中的对象属性提供。

我们的任务是将此 CSV 文件导入到 PowerShell 中，并从该文件中为每个用户更改 Active Directory。

在上一篇文章中，我们解释了如何使用 Export-CSV cmdlet 将 PowerShell 对象保存到 CSV 文件。

将此 Excel 文件另存为包含逗号分隔值的 CSV 文件。生成的文本文件应如下所示：

现在，要将 CSV 文件导入 PowerShell，您所要做的就是指定其名称（路径）：

$ADUsers=Import-CSV -path C:\PS\my_ad_users.csv

Import-CSV cmdlet 将数据从 CSV 文件转换为 PowerShell 数组。

如果 CSV 文件使用逗号以外的分隔符，您可以使用 -Delimiter 参数指定它们。例如，要导入带有分号分隔符的 CSV 文件 (

;

）使用命令：

$ADUsers=Import-CSV -path C:\PS\my_ad_users.csv -Delimiter ";"

如果在 CSV 中使用制表符作为分隔符，则可以按如下方式指定：

-Delimiter `t

如果您想在系统中使用默认分隔符（取决于语言和区域 Windows 设置），请使用

-UseCulture

旗帜。

运行以下命令以获取 Windows 中的系统默认分隔符：

(Get-Culture).TextInfo.ListSeparator

现在，如果您调用 $ADUsers 变量，它将显示 CSV 文件的内容。该 cmdlet 将文件的内容转换为数组。 CSV 文件中的所有值均表示为行。

如果您的 CSV 文件包含 UTF-8 字符编码，请确保还指定 UTF8 类型以避免编码错误：

Import-CSV -path C:\PS\my_ad_users.csv -Encoding UTF8

可用对象属性的列表可以显示如下：

$ADUsers|get-member

您可以看到数组行包含 PSCustomObjects，可以通过 CSV 文件中的列名称访问其元素。

您可以显示特定列中的所有值：

$ADusers.email

或者指定对象属性：

$ADusers| Select-Object Email, Phone

另一个有用的选项是直接访问数组中的特定对象。例如，运行以下命令获取第 4 行的值（编号从 0 开始）：

$ADusers[3]

如果要更改在 CSV 文件中指定的 Active Directory 用户的属性，只需使用 ForEach 循环迭代 $ADUsers 数组中的所有行（我们将使用 AD PowerShell 模块中的 Set-ADUser cmdlet 进行更改）。

逐一迭代数组中的所有行。在此示例中，$_. 语句意味着我们正在访问数组的当前行。您可以通过按列名称访问当前行来获取特定列的值。例如，要显示当前行的 ADLogin 值，请参阅第二行。在第三行中，我们通过 ADLogin 列的值在 AD 中搜索用户并更改其属性值：

$ADUsers | ForEach-Object {
	Write-host $_.ADLogin
	Set-ADUser -Identity $_.AdLogin -MobilePhone $_.Phone -Department $_.Department -EmailAddress $_.Email 
}

您可以将此脚本替换为更紧凑的 PowerShell 单行脚本：

Import-Csv C:\PS\my_ad_users.csv | foreach {Set-ADUser -Identity $_.AdLogin -MobilePhone $_.Phone -Department $_.Department -EmailAddress $_.Email}

有时您可能会发现下面的格式更方便。这里我们通过以下方式访问数组的当前行

$User

我们在 ForEach 语句中定义的变量：

ForEach ($User in $ADUsers){
$samaccountname = $User.ADlogin
$email = $user.Email
Write-host $samaccountname
Write-host $email
}
在某些情况下，在处理 CSV 文件中的数组元素时，您可能需要向数组添加额外的列。例如，如果要将当前日期添加到 $ADUsers 对象：
$ADUsers | add-member -membertype NoteProperty -name Date -value (Get-Date -Format dd/MM/yyyy)

以下是您可以使用 Import-CSV cmdlet 对大量对象执行管理操作的更多场景：

• 将 Exchange 邮箱导出到 PST 文件：

  Import-CSV "C:\ps\user_to_export_pst.csv" | ForEach {New-MailboxExportRequest -Mailbox $_.username -FilePath $_.UNCPathtoPst
  

• 使用 PowerShell 将用户添加到 AD 安全组：

  Import-CSV .\users.csv -Header users | ForEach-Object {Add-AdGroupMember -Identity ‘TestADGroup’ -members $_.users}
  或者将用户添加到 Azure AD 组的类似情况：
  Import-CSV "C:\PS\add_m365_members.csv" | ForEach-Object {
  Add-UnifiedGroupLinks -Identity it_dept -LinkType Members -Links $_.member
  }
  

• 从AD获取用户信息：

  Import-Csv c:\ps\usernsme_list.csv | ForEach {
  Get-ADUser -identity $_.user -Properties Name, telephoneNumber |
  Select Name, telephoneNumber |
  Export-CSV c:\ps\export_ad_list.csv -Append -Encoding UTF8
  }
  或者使用 Set-ADUser 更改特定用户的属性：
  Import-Csv "C:\ps\modifyad_users.csv" | foreach {Set-ADUser -Identity $_.SamAccountName -Title $_.Title -MobilePhone $_.MobilePhone}
  更新 Active Directory 中的用户照片：
  Import-Csv C:\PS\import.csv |%{Set-ADUser -Identity $_.AD_username -Replace @{thumbnailPhoto=([byte[]](Get-Content $_.Photo -Encoding byte))}}
  

• 从 CSV 文件中的列表在 Active Directory 中创建批量用户。