MS Teams 平常管理系列1：Teams PowerShell 命令详解

微软在5月1号发布了针对Teams 团队应用管理的命令模块：Microsoft Teams - PowerShell Module ，它可让IT管理员针对Teams中的团队应用进行管理，也只针对团队应用而已，即以下应用:

由于对于Teams，还有会有另外的一个模块进行Teams Policy & Config的管理（Skype for Business PowerShell Module），千万不能认为本次发布的Teams PowerShell是什么都能作的, 因此区分并汇总以下：

• Microsoft Teams PowerShell Module：用于Teams团队应用的增删改，频道成员的增删改等管理；同时做为IT专业人员，PowerShell对Microsoft Teams的支持使您能够作到Teams管理的自动化，使团队管理更容易：
1) IT管理员就能够帮助大量业务用户快速生成/删除所需的团队了（即团队的生命周期管理），同时应用到OA系统进行Teams团队的自动化管理了；
2) 自动配置新团队，新频道，添加成员以及设置图片和成员权限等选项。
3) 建立一个自助式服务的网站，在后端使用Teams PowerShell进行管理。例如，最终用户则能够轻松建立团队，用户浏览网站表单以建立团队，PowerShell能够检查具备重复名称的团队，以确保用户不会建立具备相同名称的团队。
4) 若是我须要向团队添加大量成员，使用PowerShell我能够从.csv批量添加这些成员。
5) 标准化每一个建立的团队中的设置。
• Skype for Business PowerShell Module：用于Teams的各类策略的增删改，各类全局的配置，即Teams Admin Portal中全部的设置均可以使用本命令来设置。

回归正题，咱们能够经过Powershell命令便可安装Teams PS Module了。咱们经过Install-Module -Name MicrosoftTeams 来自动安装本命令，很是的容易以致于我简化成如下安装截图：

Install-Module -Name MicrosoftTeams -Verbose

使用Connect-MicrosoftTeams 链接到Teams,就会显示以下内容：

您如今能够开始运行cmdlet或针对Microsoft Teams的脚本！请注意，您能够随时键入 Get-Command -Module MicrosoftTeams 以查看可用命令的完整列表：
在写本Blog的时候，有以下这些管理命令，相信之后会有更多更好的命令供你们使用(主要分为几大类：Get-TeamXXX, New-TeamXXX, Remove-TeamXXX, Set-TeamsXXX)

PS. 在尚未发布以前的0.9.0版本是比如今的1.0.0多出不少关于Setting的命令，不知道基于什么缘由没有释放到GA版本下面，一块儿期待更新吧。

接下来咱们演示一下为中国深圳的员工建立一个新的私有团队。输入如下命令，而后按Enter键：

New-Team -DisplayName “CN-ShenZhen” -Visibility Private

还能够把团队改成公共团队，配置还能够实时生效，以下：

Get-Team -DisplayName "CN-ShenZhen" | Set-Team -Visibility Public

接下来是增长团队成员，注意为了方便在如下命令中咱们使用管道符“|”来指定须要操做的团队，否则你就要在命令中指定很长的GroupId，并且也不容易记住。
Get-Team -DisplayName “CN-ShenZhen” | Add-TeamUser -User tangx@xxxxxx.com

建立出来的团队应用以后，咱们还能够经过Set-Team来修改各类设置（也许这就是上文没有把Team Setting单独列出的缘由，整合在这里面了）
下图所示，使用 “-”来自动带出全部支持的参数/设置：

如下列举各命令的用法，供参考：

Set-Team
   -GroupId <String>
   [-DisplayName <String>] 显示名称
   [-Description <String>] 描述
   [-MailNickName <String>] 
   [-Classification <String>]
   [-Visibility <String>] 设置团队是否为公共仍是私有团队，Public or Private
   [-AllowGiphy <Boolean>] 容许GIF表情
   [-GiphyContentRating <String>]
   [-AllowStickersAndMemes <Boolean>] 表情开关
   [-AllowCustomMemes <Boolean>] 自定义表情开关
   [-AllowGuestCreateUpdateChannels <Boolean>] 用于肯定访客是否能够在团队中建立与更新频道
   [-AllowGuestDeleteChannels <Boolean>]用于肯定访客是否能够在团队中删除频道
   [-AllowCreateUpdateChannels <Boolean>] 用于肯定是否容许成员（而不只仅是全部者）是否能够管理团队中的频道。
   [-AllowDeleteChannels <Boolean>] 用于肯定是否容许成员（而不只仅是全部者）删除频道。
   [-AllowAddRemoveApps <Boolean>] 用于肯定是否容许成员（不只是全部者）向团队添加应用程序。
   [-AllowCreateUpdateRemoveTabs <Boolean>] 用于肯定成员（而不只是全部者）是否能够管理频道中的Tabs.
   [-AllowCreateUpdateRemoveConnectors <Boolean>]用于肯定成员（而不只仅是全部者）是否能够管理团队中的链接器。
   [-AllowUserEditMessages <Boolean>]用于肯定成员是否能够编辑已发布的消息。
   [-AllowUserDeleteMessages <Boolean>] 用于肯定成员是否能够删除已发布的消息。
   [-AllowOwnerDeleteMessages <Boolean>] 用于肯定访客是否能够在团队中建立与更新频道
   [-AllowTeamMentions <Boolean>]肯定是否能够@说起整个团队的设置（这意味着将通知全部用户）
   [-AllowChannelMentions <Boolean>] 用于肯定是否能够@说起团队中的频道，以便通知全部关注该频道的用户。

接下来是建立团队中的频道，也是很是简单的几行命令，并且都是有规律的：

get-Team -DisplayName “CN-ShenZhen” | New-TeamChannel -DisplayName "ShenZhen Tech Dept"
get-Team -DisplayName “CN-ShenZhen” | New-TeamChannel -DisplayName "ShenZhen Sales Dept"
get-Team -DisplayName “CN-ShenZhen” | Get-TeamChannel

接下来介绍修改团队频道的命令：Set-TeamChannel，相比于Set-Team来讲这个命令比弱一点，只能修改频道的名字，其它什么都作不了，以下命令：
1） 经过管道符须要修改的频道所属的团队
2） 指定当前频道的显示名字
3） 指定要修改的频道的显示名字

Get-Team -DisplayName "CN-ShenZhen" | Set-TeamChannel -CurrentDisplayName "ShenZhen Tech Dept" -NewDisplayName "ShenZhen Tech Support Center"

最后，本文介绍了几个比较经常使用的Team团队管理的命令如（Connect-MicrosoftTeams, Get-Team, Add-TeamUser, Set-Team, Set-TeamChannel….）其它命令读者可自行尝试也是一件很是容易的事情。

最重要的是咱们能够经过Github查看本模块里面的源代码，Team Powershell是经过RESTful技术来调用了很是强大的Microsoft Graph API来对Teams进行设置/配置。经过Team Powershell里面的源码，能够学习到Microsoft Graph是如何链接到M365, 如何链接到Teams, 如何对Teams进行设置等一系列的功能。
期待下一篇的文章吧：“如何使用Team Powerhsell来学习Microsoft Graph”

如下Roadmap供参考：

Best Regards,Nemo Tan 谭国欣