ניהול Microsoft Teams באמצעות PowerShell

מודול Microsoft Teams PowerShell מיועד לנהל את Teams משורת הפקודה. באפשרותך להשתמש בפקודות מודול Teams כדי לבצע במהירות משימות ניהוליות נפוצות או בתרחישי אוטומציה. במאמר זה, נראה כיצד להתקין את מודול Teams PowerShell ונבחן פקודות אופייניות שמנהל מערכת של Microsoft 365 עשוי להזדקק להן כדי לנהל את Teams.

כיצד להתקין מודול PowerShell של Microsoft Teams?

כדי להתקין את מודול Microsoft Teams, עליך להתקין תחילה את PowerShell 5.1 ואילך במחשב שלך. באפשרותך לבדוק את גירסת PowerShell הנוכחית באמצעות הפקודה הבאה:

$PSVersionTable.PSVersion

במידת הצורך, עדכן את גירסת PowerShell שלך.

באפשרותך להתקין את מודול MS Teams מגלריית PowerShell באמצעות פקודה זו:

Install-Module -Name MicrosoftTeams

כדי לוודא שמודול Teams מותקן במחשב שלך ולהציג את הגירסה שלו, הפעל את הפקודה הבאה:

Get-Module MicrosoftTeams -ListAvailable

ניתן להתקין גרסת מודול ספציפית של Teams מ-PSGallery. פרט את גרסאות המודולים הזמינות:

Find-Module MicrosoftTeams -AllVersions

כדי להתקין גירסה ספציפית, הפעל את הפקודה:

Install-Module -Name MicrosoftTeams -RequiredVersion 4.5.0

כדי לעדכן את מודול MS Teams PowerShell:

Update-Module -Name MicrosoftTeams

באפשרותך להציג רשימה מלאה של רכיבי cmdlet במודול:

Get-Command -Module MicrosoftTeams

כיצד לנהל צוותי Microsoft באמצעות מודול PowerShell?

כדי להתחבר לדייר Teams שלך ב- Microsoft 365, השתמש בפקודה זו:

Connect-MicrosoftTeams

הזן את שם המשתמש והסיסמה שלך. אם MFA מופעל בחשבון Azure של המשתמש, עליך לאשר את הכניסה שלך.

כדי להציג את כל הצוותים בדייר שלך:

Get-Teams

כדי ליצור צוות פרטי חדש ב- Teams:

New-Team -DisplayName SysOps

כדי להציג את כל הגדרות הצוות:

get-team -DisplayName sysops|fl

GroupId : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx
InternalId : xxxxx@xxxx.xxxx
DisplayName : SysOps
Description : SysOps Wiki Team
Visibility : Public
MailNickName : msteams_xxx12a
Classification :
Archived : False
AllowGiphy : True
GiphyContentRating : moderate
AllowStickersAndMemes : True
AllowCustomMemes : True
AllowGuestCreateUpdateChannels : False
AllowGuestDeleteChannels : False
AllowCreateUpdateChannels : True
AllowCreatePrivateChannels : True
AllowDeleteChannels : True
AllowAddRemoveApps : True
AllowCreateUpdateRemoveTabs : True
AllowCreateUpdateRemoveConnectors : True
AllowUserEditMessages : True
AllowUserDeleteMessages : True
AllowOwnerDeleteMessages : True
AllowTeamMentions : True
AllowChannelMentions : True
ShowInTeamsSearchAndSuggestions : True

באפשרותך לשנות את תיאור הצוות ואת הניראות:

get-team -DisplayName sysops| Set-Team -Description "SysOps Wiki" -Visibility "Public"

כדי לשנות תמונת צוות:

get-team -DisplayName sysops | Set-TeamPicture -ImagePath c:\ps\corp_sysops.png

כדי להוסיף משתמש לצוות:

get-team -DisplayName sysops| Add-TeamUser -User maxbak@a-d.site

כדי להוסיף בעלים של צוות:

get-team -DisplayName sysops| Add-TeamUser -User maxbak@a-d.site -Role Owner

באפשרותך להוסיף משתמש לכל הצוותים בדייר שלך באמצעות קובץ script פשוט של PowerShell:

$AllTeams = Get-Team
$UserToAdd = "maxbak@a-d.site"
ForEach ($Team in $AllTeams)
{
Write-Host "Adding to $($Team.DisplayName)"
Add-TeamUser -GroupId $Team.GroupID -User $UserToAdd -Role Member
}

כדי להציג רשימה של משתמשים ובעלים של צוות:

get-team -DisplayName sysops|Get-TeamUser

כדי להציג חברים מכל קבוצות Teams ובעליהם:

$AllTeams = (Get-Team).GroupID
TeamList = @()
Foreach ($CurTeam in $AllTeams)
{ $TeamGUID = $CurTeam.ToString()
$TeamName = (Get-Team | ?{$_.GroupID -eq $CurTeam}).DisplayName
$TeamOwner = (Get-TeamUser -GroupId $CurTeam | ?{$_.Role -eq 'Owner'}).Name
$TeamMember = (Get-TeamUser -GroupId $CurTeam | ?{$_.Role -eq 'Member'}).Name
$TeamList = $TeamList + [PSCustomObject]@{TeamName = $TeamName; TeamObjectID = $TeamGUID; TeamOwners = $TeamOwner -join ', '; TeamMembers = $TeamMember -join ', '}
}
$TeamList |fl

כדי להסיר משתמש מבעלי צוות ומצוות:

get-team -DisplayName sysops| Remove-TeamUser -User maxbak@a-d.site -Role Owner
get-team -DisplayName sysops| Remove-TeamUser -User maxbak@a-d.site

כדי ליצור ערוץ פרטי חדש בצוות קיים, הפעל את הפקודה הבאה:

get-team -DisplayName sysops| New-TeamChannel -DisplayName "Windows_Wiki" -MembershipType Private

כדי להוסיף משתמש לערוץ ולהקצות לו בעלים:

get-team -DisplayName sysops| Add-TeamChannelUser -DisplayName “Windows_Wiki” -User maxbak@a-d.site -Role Owner

כדי להסיר משתמש מערוץ:

get-team -DisplayName sysops| Remove-TeamChannelUser -DisplayName "Windows_Wiki" -User maxbak@a-d.site -Role Owner

אם צוות אינו פעיל, אך ברצונך לאפשר למשתמשים להציג את התוכן שלו, באפשרותך לאחסן את הצוות בארכיון:

get-team -DisplayName sysops|Set-TeamArchivedState -Archived $true

כדי להסיר ערוץ:

get-team -DisplayName sysops | Remove-TeamChannel -DisplayName “Windows_Wiki”

כדי להסיר צוות:

get-team -DisplayName sysops | Remove-Team

באפשרותך ליצור מדיניות חדשה של Teams באמצעות מדיניות חדשה של CsTeamsMessagingPolicy:

New-CsTeamsMessagingPolicy -Identity polTeamsExternalUsers -AllowGiphy $false -AllowMemes $false -AllowUserChat $false

Identity : Tag:polTeamsExternalUsers
Description :
AllowUrlPreviews : True
AllowOwnerDeleteMessage : False
AllowUserEditMessage : True
AllowUserDeleteMessage : True
AllowUserDeleteChat : True
AllowUserChat : False
AllowRemoveUser : True
AllowGiphy : False
GiphyRatingType : Moderate
AllowGiphyDisplay : True
AllowPasteInternetImage : True
AllowMemes : False
AllowImmersiveReader : True
AllowStickers : True
AllowUserTranslation : True
ReadReceiptsEnabledType : UserPreference
AllowPriorityMessages : True
AllowSmartReply : True
AllowSmartCompose : True
ChannelsInChatListEnabledType : DisabledUserOverride
AudioMessageEnabledType : ChatsAndChannels
ChatPermissionRole : Restricted
AllowFullChatPermissionUserToDeleteAnyMessage : False
AllowFluidCollaborate : False
AllowVideoMessages : True

כדי להקצות מדיניות Teams למשתמש:

Grant-CsTeamsMessagingPolicy -Identity maxbak@a-d.site -PolicyName polTeamsExternalUsers

או לכל המשתמשים עם התכונה הספציפית ב- AzureAD:

Get-CsOnlineUser -Filter {Department -like '*External*'} | Grant-CsTeamsMessagingPolicy -PolicyName polTeamsExternalUsers

לאחר שתסיים לעבוד ב- PowerShell, זכור להתנתק מ- Microsoft Teams:

Disconnect-MicrosoftTeams