使用 Microsoft Teams PowerShell 管理 Teams

• 适用于:

  Microsoft Teams

本文介绍如何使用 Microsoft Teams PowerShell 来管理 Teams。

将本指南与 Microsoft Teams cmdlet 参考结合使用。

若要在 Teams 管理中心中管理 Teams，请参阅使用 Azure Cloud Shell管理 Teams。

使用 PowerShell 创建和管理团队

Microsoft Teams PowerShell 模块中提供了用于创建和管理团队的 cmdlet。

团队由Office 365组提供支持，因此在创建团队时，可以创建一个组。 提供了一组 cmdlet，用于在核心团队中操作，其设置 (new-team、 get-teamset-team) 、管理团队用户 (add-teamuser、 remove-teamuser) ，以及用于管理团队频道 (new-teamchannel、 remove-teamchannel) 的 cmdlet。 所有这些 cmdlet 都可以作为最终用户运行，但它们仅适用于你拥有或所属的团队。 如果你是全局管理员或 Teams 管理员，你将能够处理组织中的所有团队。

New-Team -DisplayName "Contoso Marketing" -Description "Collaboration space for Contoso's Marketing department"

注意

Microsoft Teams PowerShell 模块 cmdlet 中使用的 GroupId 与 Exchange PowerShell 模块中返回Get-UnifiedGroup的 Identity 属性相同。

使用 Azure Cloud Shell 管理 Teams

Cloud Shell是一个交互式的、经过身份验证的、可供浏览器访问的 shell，可用于管理资源。 有关Cloud Shell的详细信息，请参阅 Azure Cloud Shell。

若要访问 Azure Cloud Shell并使用 PowerShell 来管理 Teams，请登录到 Teams 管理中心。

1. 选择右上角的Cloud Shell图标。

   

2. 出现提示时，选择 “PowerShell”。

   

3. 运行以下命令以启动 Teams PowerShell 会话：

   Connect-MicrosoftTeams
   

完成这些步骤后，即可运行 Teams PowerShell 命令。

重要

若要使用 Cs* cmdlet，首先需要使用 命令连接到 Teams Connect-MicrosoftTeams -UseDeviceAuthentication 。

通过 PowerShell 管理策略

在 Microsoft Teams cmdlet 模块中查找用于管理策略 的 cmdlet。

策略是一组可精细应用于单个用户的设置。 每个策略类型都有自己的一组 cmdlet，用于创建、查看、删除和更新策略本身，然后将这些策略分配给用户。 常规结构为：

• GET 命令 (例如 Get-CsTeamsMeetingPolicy ，) ：返回可供你在组织中分配的策略文档，包括 Microsoft 创建的供你使用的策略以及你创建的自定义策略。

  • 若要仅查找在组织中创建的自定义策略，请使用 -Filter "tag:*"。

• 新 命令 (例如， New-CsTeamsMeetingPolicy) ：为组织创建新策略，以分配给组织中的用户。 并非所有策略都支持创建自定义策略。 通常，这是为了确保组织中使用的策略具有受支持的设置组合。

• SET 命令 (例如， Set-CsTeamsMeetingPolicy) ：设置给定策略上的特定值。 某些策略没有可用的 SET 命令，或者它们包含无法在策略中自定义的参数。 PowerShell 说明会告诉你哪些参数无法自定义。

  • 若要编辑默认情况下将分配给组织中未分配自定义策略的用户的策略，请运行 Set-Cs<PolicyName> -Identity Global。

• REMOVE 命令 (例如， Remove-CsTeamsMeetingPolicy) ：删除已在租户中创建的自定义策略。 如果删除已分配给组织中至少一个用户的自定义策略，该用户将回退到全局策略。

  • 实际上无法删除组织中的全局策略，但如果要将组织中的全局策略重置为 Microsoft 提供的默认设置，请运行 Remove-Cs<PolicyName> -Identity Global。

• GRANT 命令 (例如， Grant-CsTeamsMeetingPolicy) ：将策略分配给特定用户。

  • 若要删除自定义策略分配并让用户回退到组织中的默认策略，请运行 Grant-Cs<PolicyName> -Identity <User Identity> -PolicyName $null。

提示

并非所有策略都允许创建自定义策略，并且某些策略具有无法自定义的设置 (因此可以查看设置，但无法在和) 期间 set-new- 设置自定义值。 每个 cmdlet 的文档都会说明参数是否可供客户使用。

常见参数：

• 标识：对于 Get-、 Set-、 New-和 Remove-， Identity 参数将始终引用特定的策略实例。 对于 Grant， Identity 参数是指要对其应用策略的特定用户对象。

通过 PowerShell 管理配置

在 Microsoft Teams cmdlet 模块中查找用于管理配置的 cmdlet。

配置是在服务中维护的、无法在用户级别指定的设置的存储桶。 设置始终应用于整个组织。 全局配置是组织中唯一有效的配置。 每种配置类型附带两个主要 cmdlet：

• Get-Cs<ConfigurationName> 例如， () Get-CsTeamsClientConfiguration ：

• SET 命令 (例如， Set-CsTeamsClientConfiguration) ：在该类型的配置中设置属性。 指定要修改的参数。

  注意

  可以通过以下两种方式之一引用要修改的配置：通过指定 -Identity Global 或运行 Get-Cs<ConfigurationName> | Set-Cs<ConfigurationName>。

每个管理员角色可以做什么？

请阅读 使用 Microsoft Teams 管理员角色来管理 Teams ，了解哪些管理员角色可以运行每个 PowerShell cmdlet。

相关主题

安装 Teams PowerShell

Teams PowerShell 发行说明

Teams cmdlet 参考

使用 Teams 管理员角色管理 Teams