通过

使用 PowerShell 为一线员工大规模部署一线静态团队

  • 项目
  • 适用于:
    Microsoft Teams, Microsoft 365 for frontline workers

概述

你的组织是否使用大量团队来推动一线员工之间的通信和协作？ 如果需要大规模创建和管理团队，本文适合你。

可以使用 PowerShell 部署最多 500 个团队，每个团队一次最多添加 25 个用户。 还可以从现有团队大规模添加和删除用户。 使用此解决方案来满足组织的缩放需求，并显著缩短部署时间。

通过大规模部署 Teams，可以：

  • 使用预生成的模板或你自己的自定义模板创建团队。
  • 将用户作为所有者或成员添加到团队。
  • 通过从现有团队中添加或删除用户来大规模管理团队。
  • 通过电子邮件保持通知，包括完成、状态和错误（如果有）。 可以选择向最多五个人通知你部署的每批团队的状态。 团队所有者和成员在添加到团队时会自动收到通知。

本文介绍如何大规模部署 Teams。

有关如何大规模部署 Teams 的步骤概述。

设置和部署团队

重要

团队所有者必须具有 Teams 许可证。 在使用这些步骤部署团队之前，请确保所有团队所有者都具有许可证。

按照以下步骤一次最多部署 500 个团队。

步骤 1：准备 CSV 文件

为部署的每批团队创建两个 CSV 文件：

  • 一个 CSV 文件，用于定义要创建的团队。 此文件必须具有标题行，并且必须包含这些必需的列，按以下顺序，从第一列开始：

    列名称 说明
    工作组名称 团队的名称。
    现有团队 ID 如果要从现有团队中添加或删除用户，请指定团队的团队 ID。
    Visibility 团队是公共团队（组织中的任何人都可以加入）还是私人团队（用户需要获得团队所有者的批准才能加入）。 选项为“公共”和“私人”。
    团队模板 ID 如果要从预生成模板或自定义模板创建团队，请指定团队模板 ID。 有关预生成团队模板和 ID 的列表，请参阅 Teams 管理中心中的 团队模板入门。 如果要使用标准默认团队模板，请将此模板留空。

  • 映射要添加到每个团队的用户的 CSV 文件。 此文件必须具有标题行，并且必须包含这些必需的列，按以下顺序，从第一列开始：

    列名称 说明
    用户全名 用户的显示名称。
    用户 UPN 或 ID 用户的用户主体名称 (UPN) 或 ID。 例如，averyh@contoso.com。
    工作组名称 团队的名称。
    ActionType 是要添加还是从团队中删除用户。 选项为 AddMember 和 RemoveMember。
    所有者或成员 用户是团队所有者还是团队成员。 选项为 Owner 和 Member。

    注意

    在此 CSV 文件中，还可以将多个用户分配为任何团队的团队所有者，包括通过部署一线动态团队体验在 Teams 管理中心创建的 动态一线团队。

示例

使用以下示例来帮助创建 CSV 文件。 在这里，我们将文件命名为 Teams.csv 和 Users.csv。

Teams.csv

工作组名称 现有团队 ID 可见性 团队模板 ID
Contoso Store 1 公共 com.microsoft.teams.template.retailStore
Contoso Store 2 公共 com.microsoft.teams.template.retailStore
Contoso Store 3 公共 com.microsoft.teams.template.retailStore
Contoso Store 4 公共 com.microsoft.teams.template.retailStore
Contoso Store 5 公共 com.microsoft.teams.template.ManageAProject
Contoso Store 6 公共 com.microsoft.teams.template.ManageAProject
Contoso Store 7 公共
Contoso Store 8 私人 com.microsoft.teams.template.OnboardEmployees
Contoso Store 9 私人 com.microsoft.teams.template.OnboardEmployees
Contoso Store 10 私人 com.microsoft.teams.template.OnboardEmployees

Users.csv

用户全名 用户 UPN 或 ID 工作组名称 ActionType 所有者或成员
Avery Howard averyh@contoso.com Contoso Store 1 AddMember Owner
Casey Jensen caseyj@contoso.com Contoso Store 2 AddMember Owner
Jessie Irwin jessiei@contoso.com Contoso Store 3 AddMember Owner
Manjeet Bhatia manjeetb@contoso.com Contoso Store 4 AddMember Owner
Mikaela Lee mikaelal@contoso.com Contoso Store 5 AddMember Owner
Morgan Conners morganc@contoso.com Contoso Store 6 AddMember Member
Oscar Ward oscarw@contoso.com Contoso Store 7 AddMember Member
Rene Pelletier renep@contoso.com Contoso Store 8 AddMember Member
Sydney Mattos sydneym@contoso.com Contoso Store 9 AddMember Member
Violet Martinez violetm@contoso.com Contoso Store 10 AddMember Member

步骤 2：设置环境

按照以下步骤安装并连接到最新版本的 Teams PowerShell 模块。

  1. 安装 Powershell 版本 7 或更新。 有关分步指南，请参阅在 Windows 上安装 PowerShell。

  2. 以管理员模式运行 Powershell。

  3. 运行以下命令以卸载任何以前安装的 Teams PowerShell 模块。

    Uninstall-module -Name MicrosoftTeams -Force -Allversions

    如果收到错误消息，则已设置好了。 请转到下一步。

  4. 下载并安装 最新版本的 Teams PowerShell 模块。 必须运行版本 4.7.0 (预览版) 或更高版本。

  5. 运行以下命令以连接到 Teams。

    Connect-MicrosoftTeams

    出现提示时，请使用管理员凭据登录。

  6. 运行以下命令以获取 Teams PowerShell 模块中的命令列表。

    Get-Command -Module MicrosoftTeams

    验证是否列出了 New-CsBatchTeamsDeployment 和 Get-CsBatchTeamsDeploymentStatus。

步骤 3：部署团队

创建 CSV 文件并设置环境后，即可部署团队。

使用 New-CsBatchTeamsDeployment cmdlet 提交一批团队进行创建。 将为每个批生成业务流程 ID。 然后，可以使用 Get-CsBatchTeamsDeploymentStatus cmdlet 跟踪每个批的进度和状态。

  1. 运行以下命令以部署一批团队。 在此命令中，指定 CSV 文件的路径和最多五个收件人的电子邮件地址，以通知有关此部署的信息。

    New-CsBatchTeamsDeployment -TeamsFilePath "Your CSV file path" -UsersFilePath "Your CSV file path" -UsersToNotify "Email addresses"

    收件人将收到有关部署状态的电子邮件通知。 电子邮件包含已提交的批处理的业务流程 ID 以及可能发生的任何错误。

    例如：

    New-CsBatchTeamsDeployment -TeamsFilePath "C:\dscale\Teams.csv" -UsersFilePath "C:\dscale\Users.csv" -UsersToNotify "adminteams@contoso.com,adelev@contoso.com"

  2. 运行以下命令以检查提交的批处理的状态。

    Get-CsBatchTeamsDeploymentStatus -OrchestrationId "OrchestrationId"

获取一线团队使用情况分析

Teams 管理中心中的 Teams 使用情况报告 概述了 Teams 中的使用情况活动。 可以使用报表查看一线团队的使用情况详细信息，包括活动用户、活动频道、组织会议总数、上次活动日期和其他信息。

  1. 在 Teams 管理中心的左侧导航栏中， 选择“分析”& 报告>使用情况报告。

  2. 在“ 查看报表 ”选项卡上的“ 报表”下，选择“ Teams 使用情况”。

  3. 在 “日期范围”下，选择 7 天、30 天、90 天或 180 天的日期范围。 然后，选择运行报告。

  4. 在右上角，选择“ 导出到 Excel>将表格导出为 CSV”。

  5. 根据一线团队 ID 筛选电子表格。

    注意

    部署团队时，一线团队 ID 会在 PowerShell 输出中列出。