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 譚國欣