使用 Microsoft Teams PowerShell 管理 Teams
本文說明如何使用 Microsoft Teams PowerShell 來管理 Teams。
使用此指引搭配 Microsoft Teams Cmdlet 參考。
若要在 Teams 系統管理中心管理 Teams,請參閱使用 Azure Cloud Shell 管理 Teams。
使用 PowerShell 建立及管理團隊
建立及管理團隊的 Cmdlet 位於 Microsoft Teams PowerShell 模組中。
團隊是由 Office 365 群組 所支援,因此當您建立團隊時,您會建立群組。 核心團隊及其設定 (、 get-team
set-team
) 、管理團隊使用者 (new-team
、 remove-teamuser
) 和 Cmdlet,以管理團隊 (new-teamchannel
remove-teamchannel
add-teamuser
、) 頻道,提供一組 Cmdlet。 所有這些 Cmdlet 都可以以使用者身分執行,但只能在您擁有或是成員的團隊上運作。 如果您是全域系統管理員或 Teams 系統管理員,您可以對組織中的所有團隊採取行動。
重要
Microsoft建議您使用許可權最少的角色。 這有助於改善貴組織的安全性。 全域系統管理員是一個高度許可權角色,當您無法使用現有角色時,應限於緊急案例。
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 是可讓您管理資源的互動式、經過驗證且易於瀏覽器存取的殼層。 如需 Cloud Shell 的詳細資訊,請參閱 Azure Cloud Shell。
若要存取 Azure Cloud Shell 並使用 PowerShell 管理 Teams,請登入 Teams 系統管理中心。
選取右上角的 Cloud Shell 圖示。
出現提示時,選擇 [PowerShell]。
執行下列命令以啟動 Teams PowerShell 工作階段:
Connect-MicrosoftTeams
完成這些步驟之後,您就可以執行Teams PowerShell命令。
透過PowerShell管理原則
在 Microsoft Teams Cmdlet 模組中尋找管理原則的 Cmdlet。
原則是一組可細化套用至個別用戶的設定。 每個原則類型都有一組自己的 Cmdlet,用於建立、檢視、刪除及更新原則本身,然後將這些原則指派給使用者。 一般結構為:
GET 命令 (例如
Get-CsTeamsMeetingPolicy
) :傳回您可在組織中指派的原則檔,包括由Microsoft建立的原則以及您建立的自定義原則。- 若只要尋找您在組織中建立的自訂原則,請使用
-Filter "tag:*"
。
- 若只要尋找您在組織中建立的自訂原則,請使用
新 命令 (例如
New-CsTeamsMeetingPolicy
) :為貴組織建立新原則,以指派給組織中的使用者。 並非所有原則都支援建立自定義原則。 這通常是為了確保您在組織中使用的原則具有支持的設定組合。設定 命令 (例如)
Set-CsTeamsMeetingPolicy
:根據指定原則設定特定值。 某些原則沒有可用的 SET 命令,或包含無法在原則中自定義的參數。 PowerShell 描述會告訴您哪些參數無法自定義。- 若要編輯預設會指派給組織中未指派自定義原則的使用者的原則,請執行
Set-Cs<PolicyName> -Identity Global
。
- 若要編輯預設會指派給組織中未指派自定義原則的使用者的原則,請執行
移除 (命令,
Remove-CsTeamsMeetingPolicy
例如) :刪除已在租使用者中建立的自定義原則。 如果您刪除已指派給組織中至少一個使用者的自定義原則,該用戶會回復到全域原則。- 您無法實際移除組織中的全域原則,但如果您想要將貴組織的全域原則重設為Microsoft提供的預設設定,請執行
Remove-Cs<PolicyName> -Identity Global
。
- 您無法實際移除組織中的全域原則,但如果您想要將貴組織的全域原則重設為Microsoft提供的預設設定,請執行
GRANT 命令 (例如,
Grant-CsTeamsMeetingPolicy
) :指派原則給特定使用者。- 若要移除自訂原則指派,並讓使用者回覆到貴組織的預設原則,請執行
Grant-Cs<PolicyName> -Identity <User Identity> -PolicyName $null
。
- 若要移除自訂原則指派,並讓使用者回覆到貴組織的預設原則,請執行
提示
並非所有原則都允許建立自定義原則,而且有些原則有您無法自定義 (的設定,因此您可以檢視設定,但無法在) 期間 set-
new-
設定自定義值。 每個 Cmdlet 的檔會指出參數是否可供客戶使用。
常見參數:
-
身分識別:針對
Get-
、Set-
、New-
和Remove-
, 身分識別 參數會參照特定的原則實例。 針對Grant
,身分 識別 參數是指套用原則的特定用戶物件。
透過PowerShell管理設定
在 Microsoft Teams Cmdlet 模組中尋找管理您設定的 Cmdlet。
組態是服務中維護的設定貯體,無法在用戶層級指定。 設定一律會套用至整個組織。 您的全域設定是貴組織中唯一有效的設定。 每個組態類型都隨附兩個主要 Cmdlet:
Get-Cs<ConfigurationName>
(例如,Get-CsTeamsClientConfiguration
) :[設定] 命令 (例如,
Set-CsTeamsClientConfiguration
) :設定該類型的屬性。 指定您要修改的參數。注意事項
您可以使用下列兩種方式之一來參照您正在修改的設定:指定 -Identity Global 或執行
Get-Cs<ConfigurationName>
|Set-Cs<ConfigurationName>
。
每個系統管理員角色可以做什麼?
請閱讀 使用 Microsoft Teams 系統管理員角色來管理 Teams ,以瞭解哪些系統管理員角色可以執行每個 PowerShell Cmdlet。