使用 PowerShell 将用户批量添加到 Microsoft Teams

要求：从 CSV 文件将用户批量添加到 Microsoft Teams。

如何批量添加多个用户到Microsoft Teams？

Microsoft Teams 提供了一种与同事和协作者沟通的好方法。您可以通过 Teams 应用程序轻松地将用户手动添加到您的团队中，一次一个，但如果您需要添加大量用户怎么办？ Microsoft Teams 不允许您在创建新团队时批量添加成员。

好消息是我们可以利用 PowerShell 来做到这一点！将批量用户添加到 Microsoft Teams 帐户可能是一个耗时的过程，尤其是当您有大量新员工需要添加时。本文将向您展示如何在 Microsoft Teams 中添加批量用户。可以使用 PowerShell 向 Microsoft Teams 添加或删除成员/所有者，如我的另一篇文章：使用 PowerShell 管理 Microsoft Teams；这篇文章的目的是批量添加用户。

我假设您的计算机上已安装 Microsoft Teams PowerShell 模块。如果没有，请安装它：如何为 Microsoft Teams 安装 PowerShell 模块？

将用户添加到 Microsoft Teams 涉及四个步骤：

1. 使用 PowerShell 连接到 Microsoft Teams
2. 获取您要添加用户的团队的 GroupID。
3. 使用要添加到团队的所有用户的列表填充 CSV 文件
4. 使用 PowerShell 脚本读取 CSV 文件并将成员添加到团队。

步骤 1：使用 PowerShell 连接到 Microsoft Teams

首先，我们必须从 PowerShell 连接到 Microsoft Teams。使用 Connect-MicrosoftTeams cmdlet 建立连接。

Connect-MicrosoftTeams

系统会提示您登录。输入您的 Microsoft Teams 凭据以从 PowerShell 与 Teams 连接。此弹出窗口支持 MFA，因此即使您的帐户启用了多重身份验证，您也可以登录 PowerShell 并连接到 Microsoft Teams。确保您拥有要将用户添加到的团队的所有者权限。

步骤 2：获取 Microsoft 团队的组 ID

下一步是获取与特定团队关联的 GroupID。

在 Microsoft Teams 中创建团队时，还会在后端创建关联的 Microsoft 365 组。这是团队的支柱。所以，为了管理团队，我们需要获取关联组的ID。让我们从团队的显示名称中获取 GroupID：

#Get Team ID from Display Name
Get-Team | Where {$_.DisplayName -eq "Learning Portal"} | Select -ExpandProperty GroupID

如果您不确定团队的显示名称，只需使用 Get-Team cmdlet 即可获取环境中的所有团队。

#Get All Teams
Get-Team

步骤 3：使用要添加到团队的用户填充 CSV 文件

这是我的 CSV 文件。只需指定用户的电子邮件和角色即可在 CSV 中分配成员或所有者。

在这里，我使用了用户的电子邮件和角色在 CSV 文件中进行分配。您还可以使用 TeamName 作为参数。

步骤 4：使用 PowerShell 将用户从 CSV 导入到 Microsoft Teams

最后，这是完整的 PowerShell 脚本，用于从 CSV 文件将多个用户添加到现有的 Microsoft Teams 团队！

#Get users from the CSV
$TeamUsers = Import-Csv -Path "C:\Temp\TeamsUsers.csv"

#Iterate through each user from the CSV and add to Teams
$TeamUsers | ForEach-Object {
       Add-TeamUser -GroupId $TeamID -User $_.Email -Role $_.Role
       Write-host "Added User:"$_.Email -f Green
}

用于将用户批量添加到 Microsoft Teams 的 PowerShell 脚本

让我们引入参数并为上面的块添加一些错误处理。以下是从 CSV 批量添加用户到 Microsoft Teams 的完整脚本：

#Parameters
$CSVPath = "C:\Temp\TeamsUsersTemplate.csv"
$TeamDisplayName = "Learning Portal"

Try {
    #Connect to Microsoft Teams
    Connect-MicrosoftTeams

    #Get Team ID from Display Name
    $TeamID = Get-Team | Where {$_.DisplayName -eq $TeamDisplayName} | Select -ExpandProperty GroupID

    #Get users from the CSV
    $TeamUsers = Import-Csv -Path $CSVPath

    #Iterate through each user from the CSV and add to Teams
    $TeamUsers | ForEach-Object {
        Try {
            Add-TeamUser -GroupId $TeamID -User $_.Email -Role $_.Role
            Write-host "Added User:"$_.Email -f Green
        }
        Catch {
            Write-host -f Red "Error Adding User to the Team:" $_.Exception.Message
        }
    }
}
Catch {
    write-host -f Red "Error:" $_.Exception.Message
}

您还可以使用此脚本将来宾用户批量添加到 Microsoft Teams！