共用方式為


安裝 Teams 以支援虛擬化桌面基礎架構 (VDI)

本文說明在虛擬化環境中使用 Microsoft Teams 用戶端的需求與限制。

需求

要成功安裝 Teams 用戶端,你需要版本 23306.3314.2555.9628 或更高。 此外,虛擬機必須符合以下列出的最低要求:

需求 版本
Windows - Windows 10.0.19041 或更高版本 (不包含不支援的 Windows LTSC for Teams 桌面應用程式,因為這些應用程式不支援)
- Windows Server 2019 (10.0.17763)
- Windows Server 2022 (20348.2402) 或更高
版本 - Windows Server 2025 (26100.2886) 或以上
-Windows Server 2016 不支援。 規劃升級。
- Windows Server 與 Windows 10/11 多使用者環境中必備的 WebView2 框架
Webview2 更新到最新版本。 了解更多: WebView2 執行環境的企業管理
場景設定 在 Microsoft Teams 的系統>通知>中開啟「顯示通知橫幅」設定以接收 Teams 通知。
排除防毒軟體與 DLP 將 Teams 加入防毒和 DLP 應用程式,讓 Teams 能正確啟動。
了解更多: 排除防毒軟體與 DLP 應用程式阻擋 Teams

備註

現代生命週期政策定義了對 Microsoft Teams 與 Microsoft 365 Apps 的支援,要求客戶維持最新配置以維持支援。 請在此查看 Microsoft Teams 服務協議。
若 Teams 版本超過 60 天,應用程式內會顯示警示;超過 90 天的版本則會看到封鎖頁面。
詳情請參考訊息中心貼文931401。
Windows Server 2019 與 Windows Server 2022 的支援終止日期分別為 2025 年 10 月與 2026 年 10 月。 欲了解更多資訊,請點 此連結

虛擬化提供者需求

目前,具備音訊/視訊 (視聽) 優化功能的 VDI Teams 已獲得 Azure Virtual Desktops、Windows 365、Citrix、Omnissa 和 Amazon 的認證。 請參考本文資訊,確保您符合所有正常運作的要求。

關於 RDS 情境,請參考 本節

Azure Virtual Desktop

Azure Virtual Desktop 提供 VDI 上的 Teams 防毒優化。 欲了解更多需求與安裝資訊,請參閱「在 Azure 虛擬桌面上使用 Teams」。

以下最低版本是支援 Teams 用戶端的必要條件:

  • Windows 1.2.5405 遠端桌面用戶端

  • Windows 應用程式 2.0.360.0

  • Mac 10.9.7 遠端桌面用戶端

  • Mac 11.1.4 (2557) Windows 應用程式

  • Windows 應用程式 iOS 11.1.7 (5679) 【僅限基於 WebRTC 的優化公開預覽版】

  • Android 版 Windows 應用程式 (11.0.0.40) 【僅公開預覽版支援基於 WebRTC 的優化】

  • 網頁瀏覽器不支援 Microsoft Teams 的優化

  • Linux 瘦客戶端 - 僅本 列出的合作夥伴支援 Microsoft Teams 優化 (基於 WebRTC 的)

  • WebRTC 重定向服務 1.54.2408.19001

Microsoft 建議使用最新可用的版本。

備註

使用 Linux 瘦客戶端的客戶,若遇到 Teams 多媒體或優化相關問題,必須先聯繫其瘦客戶端供應商的技術支援。 若問題非多媒體或優化相關,客戶可直接聯繫 Microsoft 支援團隊。

此外,你必須在虛擬桌面部署以下登錄檔金鑰,以便優化 Teams 用戶端:

HKLM\SOFTWARE\Microsoft\Teams:

  • 名稱:IsWVDEnvironment
  • 類型:DWORD
  • 數值:1

遠端應用程式

你可以用 Windows shell:appsFolder 位置以格式 shell:appsFolder\MSTeams_8wekyb3d8bbwe!MSTeams發佈 Teams:。

欲了解更多 RemoteApp 資訊,請參閱 此文章

Windows 365

Windows 365 採用與 Azure 虛擬桌面相同的音訊/視訊優化,確保雲端 PC Teams 的體驗達到最佳。 欲了解更多需求與安裝資訊,請參閱 使用 Teams on Cloud PC 的資訊。

圖庫中的 Windows 10/11 映像檔已預先設定並具備必要的優化元件。 當你在雲端電腦安裝並使用 Microsoft Teams 時,你會獲得最佳化的體驗。

如果你想建立包含 Microsoft Teams 優化的自訂映像檔,你需要執行「 建立自訂雲端映像檔以支援 Microsoft Teams 的步驟。

支援 Windows 365 Teams 用戶端,必須符合 Azure 虛擬桌面的最低版本。 詳見上文章節。

此外,你必須在虛擬桌面部署以下登錄檔金鑰,以便優化 Teams 用戶端:

HKLM\SOFTWARE\Microsoft\Teams:

  • 名稱:IsWVDEnvironment
  • 類型:DWORD
  • 數值:1

Citrix 虛擬應用程式與桌面,以及 Citrix DaaS 需求

以下最低版本是支援 Teams 用戶端的必要條件:

Citrix Workspace 應用程式:

  • Windows 2402 LTSR (以及任何 CU)
  • Windows 2405 CR
  • Linux 2408
  • Mac 2405
  • HTML5 2404.1
  • ChromeOS - 最新 Citrix Workspace 應用程式,適用於 ChromeOS 發布於 Chrome 網路商店。 先前 (N-1 的) 版本在相容的 ChromeOS 版本中得到支援,並持續維護至下一個版本。

備註

Unicon(現為 Citrix 的一部分)及其 eLux 作業系統 (一套安全、輕量、硬體無關的 Linux 作業系統,用於受管理端點) 並完全支援基於 WebRTC 的優化,直到新的 VDI 優化 (,也稱為 VDI 2.0) 交付給基於 Linux 的平台。 請持續關注 Microsoft 365 路線圖以獲取公開公告。 欲了解更多Unicon資訊,請造訪Citrix網站 https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/2411/unicon.html

Citrix 虛擬交付代理 (VDA) :

  • 2507 LTSR (及任何信用合作)
  • 2402 LTSR (及任何信用合作)
  • 2203 LTSR (及任何信用合作)
  • 2407 CR
  • 1912年LTSR不支援

此外,你必須在 VDA 上部署以下登錄檔金鑰,以便優化 Teams 用戶端:

  • 地點:HKLM\SOFTWARE\WOW6432Node\Citrix\WebSocketService
  • 關鍵 (REG_Multi_SZ) :ProcessWhitelist
  • 價值:msedgewebview2.exe

如果缺少這個登錄檔金鑰,Teams 用戶端會以非優化模式運作 (伺服器端渲染) 。 如果你使用 VDA 2402,這個 regkey 已經不需要了 (可以 點此 查看更多細節) 。

備註

Citrix Virtual Apps (也稱為已發佈應用程式) 目前支援 VDA 2402 LTSR。

欲了解更多資訊,請參閱 Microsoft Teams 優化

Omnissa Horizon 與 Workspace ONE 需求

備註

Horizon 與 Workspace ONE 由 Omnissa 開發並維護。

以下最低版本是支援 Teams 用戶端的必要條件:

  • 地平線8 2111 ESB (8.4)

欲了解更多最新需求與說明,包括如何配置 Teams 媒體優化,請參閱 Microsoft Teams 與 Horizon 的優化 |奧姆尼莎

Amazon WorkSpaces 需求

詳情請參閱 基於 SlimCore (新的 VDI 優化頁面) 。 AppStream 不被支援。

部署 Microsoft Teams 用戶端

要將 Microsoft Teams 用戶端部署到您的組織,請選擇以下選項之一。

重要

你必須使用最新版本的 bootstrapper.exe。 如果 .exe 已經下載過,請查看你版本的 「屬性 > 詳情」 > 產品版本 ,並與最新下載的屬性做比較。

安裝 Teams 用戶端

推薦的 VDI 部署 Teams 的方法。 此選項採用直接部署或「批量部署」方法。 了解更多資訊: Bulk部署 Microsoft Teams 桌面客戶端

使用 teamsbootstrapper.exe -p 指令,總是能確保安裝最新的 Teams 用戶端。

接著可透過選擇性擴展新的電腦目錄/交付群組分配至更多使用者,實現分階段且受控的部署。

管理員也可以使用本地 Teams 的 MSIX 來配置 Teams。 此選項可減少初始安裝時使用的頻寬。 MSIX 可以存在於本地路徑或 UNC。

  1. 下載 .exe 安裝程式。

  2. 下載 MSIX:
    - MSIX x86
    - 、MSIX x64
    - 、ARM64

  3. 以管理員身份開啟命令提示字元。

  4. 根據你的 MSIX 所在地點,請採取以下步驟:

    對於本地路徑,請輸入:.\teamsbootstrapper.exe -p -o “c:\path\to\teams.msix”

    例:

    離線安裝程式的本地路徑位置

    UNC 輸入:.\teamsbootstrapper.exe -p -o 「\unc\path\to\teams.msix」

    例:

    使用 UNC 的離線定位

備註

Teamsbootstrapper.exe 日誌位於 C:\WINDOWS\Temp\teamsprovision.log.xxxxxxxx。

如果 IT 管理員對 MSIX 設下限制或部署 GPO,可能會阻止使用者下載並安裝該應用程式。 如果有限制,使用者可能會看到像這樣的錯誤:

組織政策錯誤。

VDI 環境中的 Teams 安裝程式

你應該知道 Teams 客戶端的安裝位置。

安裝程式格式 安裝地點 自動更新
經典 Teams MSI 搭配 ALLUSERS=1 標誌 C:\程式檔案 (x86) \Microsoft\Teams 已停用
經典團隊 .EXE %localappdata%\Microsoft\Teams Enabled
新團隊 .EXE 自創 Teamsbootstrapper.exe 是一款輕量級的線上包裝安裝程式,具備無頭指令列介面。 它允許管理員在特定目標電腦上為所有使用者「配置」 (安裝) 應用程式。
它會在目標電腦上安裝 Teams MSIX 套件,確保 Teams 能與 Office 及其他 Microsoft 軟體正確互通。
C:\Program Files\WindowsApps\PublisherName.AppName_AppVersion_architecture_PublisherID

範例
C:\Program Files\WindowsApps\MSTeams.23306.3314.2555.9628_x64_8wekyb3d8bbwe
啟用。 它可以透過 regkey 來停用。 了解更多: 停用新的 Teams 自動更新

故障排除 Teams 部署錯誤

管理員可以依賴描述問題的 teamsbootstrapper.exe 錯誤代碼 。 如果錯誤代碼無法提供足夠資訊,更多診斷資訊可在詳細事件日誌中找到。

  1. 事件檢視器 (Windows Microsoft) >> Local 應用程式與服務日誌>

  2. 請檢查以下類別下的可用日誌:

    • AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
    • AppXDeployment-Server > Microsoft-Windows-AppXDeploymentServer/Operational
  3. AppXDeployment-Server 下查看日誌。

    更多資訊請見: 常見錯誤代碼

    Teamsbootstrapper.exe 常見錯誤代碼 更多資訊
    0x80070057 bootstrapper 指令沒有完整的路徑 (用 .) 避免 URI。 試試完整路徑, (例如 c:\temp\MSTeams-x64.msix) 。
    0x80070032 這是北卡羅來納大學路徑上的一個可能錯誤。 試著把 MSIX 複製到本地資料夾。
    0x80004004 可能在 HKLM\Software\WoW6432Node\Microsoft\Office\Teams 裡遺留了一個 regkey 'maglevInstallationSource'。 試著刪除它再重新嘗試安裝。

Windows Server 2019 安裝說明

對於 Windows Server 2019,唯一支援的安裝方式是:

Dism /Online /Add-ProvisionedAppxPackage /PackagePath:<MSIX package path> /SkipLicense

請確保側載已啟用,且 WebView2 已安裝。 請參閱 需求 章節。

/SkipLicense這個指令是因為 MSIX 套件不被視為「Store Package」 (,因為它不是從商店) 下載的。 因此,要讓 Dism 安裝指令成功,你也需要在安裝時啟用此政策:電腦配置 > 管理範本 > Windows 元件 > 應用程式套件部署 >允許所有受信任應用程式安裝

重要

AllowAllTrustedApps 必須在 Teams 套件成功在金色映像中暫存後啟用。 否則,每個使用者的套件註冊 (只在登入) 時會失敗,使用者無法啟動該應用程式。

已知限制:

  • 如果你使用 FSLogix 作為設定檔管理器解決方案,Teams on 2019 Windows Server 需要 FSLogix 2210 HotFix 4 或更高版本 (Microsoft推薦最新版本) 。

Windows Server 2019 中 Outlook 與 Teams 的 Presence 整合

為了讓 Outlook 正確顯示在線狀態,黃金映像需要以下步驟:

  1. 在「Windows 10 1809 和 Windows Server 2019 KB5035849 240209_02051 功能 Preview.msi」) 安裝全機 (ALLUSERS=1。

  2. 打開你的群組原則編輯器。 請前往電腦配置\管理範本\KB5035849 240209_02051功能預覽\Windows 10 版本 1809 Windows Server 2019。 把該設定的值改成 啟用

  3. 安裝 2024 年 3 月 KB5035849Microsoft Update Catalog 或 WSUS for Enterprises 的累積更新。

  4. 在「MSTeamsNativeUtility.msi」) 安裝全機 (ALLUSERS=1。

  5. 重新啟動虛擬機。

  6. 安裝 Teams 24033.811.2738.2546 或更高版本,使用 Dism 格式如前所述。

    備註

    步驟1、2、3、4和5只需完成一次。 這些步驟在後續的黃金形象維護中並非必需。

    重要

    Outlook 必須在 Teams 啟動 啟動,才能正確顯示在席狀態。

移除所有使用者的 Teams

要解除安裝並取消所有使用者的 Teams 配置,請使用以下指令:

./teamsbootstrapper -x

此指令會取消註冊並取消所有使用者的 Teams 配置。 Teams 使用者設定檔/快取已被刪除。

在非持久性 VDI 中停用 Teams 自動更新

為了防止 Teams 自動更新,請在虛擬機上使用以下登錄檔金鑰。 只有 Teams 建置超過 23306.3314.2555.9628 的 VDI 版本才能處理這個登錄檔金鑰。

Location: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams
Name: disableAutoUpdate
Type: DWORD
Value: 1

重要

如果這個 regkey 存在於虛擬機器中,Teams MSIX 安裝程式不會嘗試安裝或升級 Teams 會議外掛 (TMA) 。 管理員必須使用腳本或其他部署工具來配置 TMA。 欲了解更多資訊,請參閱本文的 Teams 會議附加元件 區塊。

球隊自動啟動

三個元件控制 Teams 的自動啟動行為:

  1. 預設情況下,基於 MSIX 的應用程式直到首次啟動時才會自動啟動,因為 Windows 作業系統不會自動啟動已配置狀態的套件。 需經用戶同意進行 AppX 註冊。 首次啟動後,使用者可進入 設定>一般 ,填入 自動啟動 Teams 的核取框,或從 Windows 設定選單啟用自動啟動。

  2. 如果「自動啟動 Teams」的核取框是灰色的,表示系統範圍的 GPO 正在停用 UWP 應用程式的這個選項:

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System] 
    "EnableFullTrustStartupTasks"=dword:00000000
    "EnableUwpStartupTasks"=dword:00000000
    "SupportFullTrustStartupTasks"=dword:00000000
    "SupportUwpStartupTasks"=dword:00000000
    

    這個登錄檔設定會導致作業系統中「設定>>應用程式已安裝應用程式」中的選項無法使用。 若要更改此設定,請建立包含以下數值的 regkey,如本範例所示:

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System]
    "EnableFullTrustStartupTasks"=dword:00000002
    "EnableUwpStartupTasks"=dword:00000002
    "SupportFullTrustStartupTasks"=dword:00000001
    "SupportUwpStartupTasks"=dword:00000001
    

    重新啟動虛擬機器,就能看到作業系統設定選單中啟動的啟動選項。

  3. 這個登錄檔金鑰控制 Teams 的自動啟動行為,因此你可以透過程式方式啟用或停用它。

    [HKEY_CURRENT_USER\Software\Classes\Local Settings\Software\Microsoft\Windows\CurrentVersion\AppModel\SystemAppData\MSTeams_8wekyb3d8bbwe\TeamsTfwStartupTask]
    "State"=dword:00000002
    "UserEnabledStartupOnce"=dword:00000001
    
    消息
    已停用 0 任務被停用。
    使用者停用 1 使用者關閉了該任務。 只有使用者能重新啟用該任務。
    EnabledByUser 2 任務已啟用。
    DisabledByPolicy 3 管理員或群組政策關閉了該任務。 不支援啟動任務的平台也會回報 DisabledByPolicy。
    啟用政策 4 管理員或群組政策啟用了該任務。

    你可以在這個 連結了解更多。

重要

如果你使用非持久性 VDI,必須確保 TeamsTfwStartupTask 登錄檔金鑰是漫遊的。 FSLogix 的 ODFC 容器不會漫遊這個登錄檔金鑰,所以你必須依賴其他設定檔管理工具 (Omnissa DEM、AppSense、Citrix UPM) 來持久化這個金鑰。

Teams 用戶端的設定檔與快取位置

所有使用者設定與設定現在都儲存在:

  • C:\Users<username>\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\
  • C:\Users<username>\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\Settings\settings.dat
  • C:\Users<username>\AppData\Local\Publishers\8wekyb3d8bbwe\TeamsSharedConfig\app_switcher_settings.json
  • C:\Users<username>\AppData\Local\Publishers\8wekyb3d8bbwe\TeamsSharedConfig\tma_settings.json

確保這些資料夾和檔案是持久的,才能讓 Teams 正常運作。

備註

AppData\Local\Packages\MSTeams_8wekyb3d8bbwe 下 所有 必要的目錄和頂層資料夾結構必須正確設定為目錄,而非檔案或解析點,並且能隨使用者設定檔漫遊:

AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\AC AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\AppData AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalState AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\RoamingState AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\Settings AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\SystemAppData AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\TempState

TeamsSharedConfig 底下的資料夾「meeting-addin」不應該被持久化,因為持續存在可能會影響 Outlook 中插入的會議範本中的預設會議座標。

重要

Microsoft 建議使用 FSLogix 2210 HotFix 4 (2.9.8884.27471) ,以確保能在 VDI 中與 Teams 用戶端正確整合。 該版本已解決以下問題:

  • Windows Server 2019 有時會在登出時無法查詢已配置的 AppX 應用程式。
  • 不該備份的 MSIX 資料夾 會在登出時移除,而非只移除該資料夾的內容。
  • 新的 Microsoft Teams 在 Windows Server 2019 中當機或無法啟動。
  • 新的 Microsoft Teams 在啟動時會顯示錯誤,顯示 「參數錯誤」。
  • 新的 Microsoft Teams 在啟動時會顯示錯誤,顯示「 無效功能」。
  • 新的 Microsoft Teams 在使用 ODFC 容器登入時無法按需註冊。
  • 新的 Microsoft Teams 在建立個人檔案時無法按需註冊,未來登入時也無法註冊,儘管已安裝。
  • 使用者自訂的群組原則設定在政策設定被移除或停用後,仍會保留在使用者的個人檔案中。

便條: 使用 Profile 和 ODFC,或僅是 ODFC 容器的客戶,仍需新增「IncludeTeams」設定,才能保留 Teams 使用者資料/快取。

備註

在 VDI 環境中,Teams 用戶端不支援資料夾重定向或漫遊使用者設定檔,因為他們無法漫遊 AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams 的資料夾。 客戶可繼續使用資料夾重定向或漫遊使用者設定檔,搭配如 FSLogix、Citrix Profile Manager 及 Omnissa DEM 等互補產品,這些產品可自由移動 Appdata\Local 資料夾。

重要

Citrix 推薦使用 Citrix Profile Manager 版本 2402 或 2203 CU5。 這些版本會處理 Teams 註冊錯誤以及啟動應用程式時的「參數錯誤」錯誤。 如果客戶仍遇到 Teams 相關問題,請聯絡 Citrix 為 2402 CU1 或 2203 CU6 建立私人建置。

使用 DEM 搭配 Windows 作業系統優化工具的 Omnissa 客戶,若在工具介面的「選擇清除資訊」中勾選「清潔預設使用者設定檔」,可能會遇到 Teams 應用程式啟動失敗的情況。

資料夾排除

磁碟儲存的使用情況

為了讓客戶端更容易分發到 Windows 裝置,新增了對 MSIX 的支援,提升了安裝與應用程式更新的可靠性,同時減少了網路頻寬與磁碟空間的消耗。 此封裝技術同時顯示精確的磁碟空間使用情況。

磁碟容量 - 金鑰資料夾與位置

  • 應用程式安裝程式:C:\Program Files\WindowsApps\MSTeams_[version]_[arch]__8wekyb3d8bbwe包含安裝套件,支援重置應用程式的功能,並允許單一實例化。
  • 使用者與應用程式資料:C:\Users<alias>\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe 包含 JavaScript 套件 (程式碼) 、程式碼快取、瀏覽器快取、使用者資料資料庫 (如對話(依使用量) 可擴展),以及來自 Teams 內託管網域(如 Sharepoint、Viva Learning、Apps 等)的網頁儲存 () 。

對於非持久化且需考慮儲存空間的架構,適用以下指引:

資料夾 資料夾路徑 角色 排除影響
日誌 LocalCache\Microsoft\MSTeams\Logs
LocalCache\Microsoft\MSTeams\PerfLog
診斷、性能記錄等等。 沒有影響。
WebStorage LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\WebStorage 瀏覽器在使用 iframe 存取網頁應用程式內其他網頁應用程式時所使用的儲存空間。 例如,在 Teams 中載入 SharePoint、OneDrive 和 Office 應用程式。 清除快取後重新載入這些應用程式可能會變慢。
GPU 快取 LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\GPUCache GPU 快取。 沒有影響。
StartMenuExperienceHost AppData\Local\Packages\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\TempState 負責 開始選單 按鈕及其內的圖塊。 沒有影響。 建議排除這個選項以解決開始選單中缺少 Teams 圖示的問題。
ShellExperienceHost 2019 Windows Server (僅) AppData\Local\Packages\Microsoft.Windows.ShellExperienceHost_cw5n1h2txyewy\TempState 負責 開始選單 按鈕及其內的圖塊。 沒有影響。 建議排除這個選項以解決開始選單中缺少 Teams 圖示的問題。
檢視這些環境所需的權衡考量,並評估與測試
資料夾 資料夾路徑 角色 排除影響
服務業人員 LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ Service Worker\CacheStorage
LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\Code 快取
程式碼並快取應用程式執行的網頁/JS 腳本。 - 每次應用程式啟動
時下載與載入腳本時效能降低- 無法離線存取應用程式
索引資料庫 LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\IndexedDB 儲存應用程式與使用者資料,是網頁應用程式中大規模快取資料以提升響應速度的推薦方式。 - 應用程式啟動時間顯著增加,因為資料 (如聊天或頻道對話) 必須被拉低,網路使用量也需每次下載與快取資料。
- 資料大小會依使用者資料而異。
- 使用者可能會在啟動畫面看到「我們正在為你設定」。
快取 LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\Cache 瀏覽器使用並管理所有離開應用程式的網路通話內容的快取。 也稱為磁碟快取。 例如,瀏覽器會將 Teams 的個人照片快取到這個儲存空間。 這些照片需要重新下載。

除了本區的資料夾外,我們不建議排除其他目錄。

Teams 與 Outlook 整合

設定 > 一般 > 系統 中選擇「註冊新 Teams 作為 Microsoft 365 聊天應用程式」的選項,讓 Teams 用戶端能與Microsoft所有具備即時訊息功能 () 的 365 應用程式整合。

例如,Outlook 會進行此處所述的發現流程,與預設的即時通訊客戶端應用程式整合: 整合即時通訊應用程式與 Office

Teams 會議外掛

此外,Teams MSIX 套件還將 Teams 會議外掛 ((TMA)) MSI (「MicrosoftTeamsMeetingAddinInstaller.msi」) 捆綁。 TMA 讓你能從 Outlook 預約 Teams 會議。

關於 TMA 與 Outlook 用戶端整合的安全文章,請參考 使用 Outlook 用戶端時的 Teams 會議附加元件安全相關資訊。

所有安裝在電腦上的 Teams 檔案都會有簽名,因此 IT 管理員可以使用 AppLocker、Code Integrity、Windows Defender Application Guard 這些政策來執行。

  • 對於 Teams 的每位使用者安裝 TMA,安裝資料夾位於 AppData\Local\Microsoft\TeamsMeetingAdd-in
  • TMA MSI 的安裝日誌儲存在此: AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs \tma_addin_msi.txt

備註

在非持久性環境 (例如Windows Server或Windows 10/11單人或多人) 中,安裝 MicrosoftTeamsMeetingAddinInstaller.msi 可能會因錯誤訊息「安裝成功或錯誤狀態:1625.」而失敗。

此錯誤由 GPO 影響 Windows 安裝程式所引起,包含基於 Publisher 規則條件的 DisableUserInstallsDisableMSI 或 AppLocker 政策,或是針對 MSI 安裝的 RuleCollection 政策。 在這種情況下,你必須建立一個例外,例如:

  • FilePathCondition Path=“%PROGRAMFILES%\WINDOWSAPPS*\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI”

非持久環境的部署方法,且 Teams 自動更新被停用

備註

teamsbootstrapper.exe (產品版本 1.0.2508703) 現在支援一個額外參數,能自動安裝 Teams 會議附加元件 (TMA) 用於 Outlook, (例如,msiexec /ALLUSERS=1) 。

-全新安裝 (配置 Teams 並安裝全機 TMA) : teamsbootstrapper.exe -p --installTMA

-如果 Teams 已經配置好,而你只想安裝 TMA:teamsbootstrapper.exe --installTMA

-卸載 TMA (Outlook Classic 必須關閉) : teamsbootstrapper.exe --uninstall TMA

- 卸載 Teams 和 TMA (Outlook Classic 必須關閉) : teamsbootstrapper.exe -x

-如果 Teams 未配置 (不存在或未能配置) ,則 TMA 未安裝

-teamsbootstrapper.exe 僅執行 -p 或 teamsbootstrapper.exe -p -o「完整路徑到 msix」並不會在全機安裝 TMA

- 使用 bootstrapper 嘗試卸載 TMA 時,必須關閉 Outlook Classic。

如果管理員不想使用新的 --installTMA 旗標,他們仍可透過管理員命令提示字元安裝 Teams 安裝目錄中的 TMA MSI,方法如下:


msiexec.exe /i "C:\Program Files\WindowsApps\MSTeams_X.X.X.X_x64__8wekyb3d8bbwe\MicrosoftTeamsMeetingAddinInstaller.msi" ALLUSERS=1 /qn /norestart TARGETDIR="C:\Program Files (x86)\Microsoft\TeamsMeetingAdd-in\<version>\"

  • TARGETDIR 必須在不同安裝間保持一致,讓 Teams 會議外掛 MSI 能偵測並清理舊版本。 若使用多個目錄,安裝可能無法如預期運作。

  • X.X.X.X 需要被 Teams 版本取代。 確保 CPU 架構 x64) 和 PublisherID ( (8wekyb3d8bbwe) 之間有雙重劃線。 可透過執行 PowerShell 指令擷取精確版本號:

    
    Get-AppXPackage -Name "*msteams*" | Select-Object -ExpandProperty Version
    
    
  • 版本必須 被替換為 MSI 檔案版本,例如 1.24.2203.0。 可透過執行 PowerShell 指令擷取精確版本號:


PS C:\WINDOWS\system32> Get-AppLockerFileInformation -Path "C:\PROGRAM FILES\WINDOWSAPPS\MSTEAMS_24026.1000.2656.1710_X64__8WEKYB3D8BBWE\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI" | Select -ExpandProperty Publisher | select BinaryVersion

BinaryVersion

1.24.2203.0

例: 以下是最後指令的範例:


msiexec.exe /i "C:\Program Files\WindowsApps\MSTeams_23320.3021.2567.4799_x64__8wekyb3d8bbwe\MicrosoftTeamsMeetingAddinInstaller.msi" ALLUSERS=1 /qn /norestart TARGETDIR="C:\Program Files (x86)\Microsoft\TeamsMeetingAdd-in\1.24.2203.0\"

以下的 PowerShell 腳本可作為部署參考。 客戶應在其 QA/TEST 環境中進行驗證:

If (-not ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] 'Administrator') ){
    Write-Error "Need to run as administrator. Exiting.."
    exit 1
}

# Get Version of currently installed Teams Package
if (-not ($NewTeamsPackageVersion = (Get-AppxPackage -Name MSTeams).Version)) {
    Write-Host "Teams Package not found. Please install Teams from https://aka.ms/GetTeams ."
    exit 1
}
Write-Host "Found Teams Version: $NewTeamsPackageVersion"

# Get Teams Meeting Addin Version
$TMAPath = "{0}\WINDOWSAPPS\MSTEAMS_{1}_X64__8WEKYB3D8BBWE\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI" -f $env:programfiles,$NewTeamsPackageVersion
if (-not ($TMAVersion = (Get-AppLockerFileInformation -Path $TMAPath | Select-Object -ExpandProperty Publisher).BinaryVersion))
{
    Write-Host "Teams Meeting Addin not found in $TMAPath."
    exit 1
}
Write-Host "Found Teams Meeting Addin Version: $TMAVersion"

# Install parameters
$TargetDir = "{0}\Microsoft\TeamsMeetingAdd-in\{1}\" -f ${env:ProgramFiles(x86)},$TMAVersion
$params = '/i "{0}" TARGETDIR="{1}" /qn ALLUSERS=1' -f $TMAPath, $TargetDir

# Start the install process
write-host "executing msiexec.exe $params"
Start-Process msiexec.exe -ArgumentList $params
write-host "Please confirm install result in Windows Eventlog"

安裝後,重新啟動 Outlook,確認 TMA 正在載入。 日誌存放在 %localappdata%\Temp\Microsoft\Teams\meeting-addin。

關於 Teams 會議外掛故障排除文章,請參考: 解決 Outlook Teams 會議外掛問題

Teams 與 Outlook 整合故障排除

症狀

當你在 Outlook 中檢查使用者的在線狀態時,會看到以下任何問題:

  • 存在指示器看不到。
  • 顯示的存在感是錯誤的。
  • 存在狀態為 未知狀態。

故障排除步驟

  1. 確保 Teams 有在運行。 然後啟動 Outlook。

  2. 檢查你電腦的登錄檔設定,確認 Teams 是否被註冊為即時通訊 (即時通訊 App) 。

    1. 啟動登錄編輯器。
    2. 找到以下子鍵: HKEY_CURRENT_USER\Software\IM Providers
    3. 請驗證以下數值:
     - **Name:** DefaultIMApp
     - **Type:** REG_SZ
     - **Data:** MsTeams
     ```
    
    
  3. 找到以下子鍵:

    • HKEY_CURRENT_USER\Software\IM Providers\MsTeams (Outlook 會監控這個登錄鍵以判斷值變更)
  4. 請驗證以下數值:

    -名稱:UpAndRunning -類型:REG_DWORD -資料:2 (0—未執行,1—啟動中,2—執行中)

  5. 如果問題持續,請聯絡 Microsoft 支援服務。

Teams 中的控制備援模式

當使用者從不支援的端點連線時,使用者處於備用模式,音訊/視訊並未被優化。 您可以透過設定以下登錄檔 DWORD 值之一來停用或啟用備援模式:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams\DisableFallback HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Teams\DisableFallback

  • 此登錄檔金鑰只能由 Teams 24257.x.x.x 或更高等級處理。
  • 要停用備用模式,請將數值設為 1。
  • 若要只啟用音訊,請將數值設為 2。
  • 如果該值不存在或設定為 0 (0) ,則啟用備援模式。
  • 在 Fallback 中,螢幕分享功能支援不同的螢幕選擇器介面 (類似使用者在 Teams for Web) 上看到的體驗。

VDI 中的多租戶與多帳號

VDI 中的 Teams 讓你能快速且輕鬆地登入,並且能 在同一 Microsoft 365 雲端環境中切換多個帳號和組織。

備註

VDI 不支援跨雲訪客和跨雲會議。 欲了解更多資訊,請參閱 「與其他 Microsoft 365 雲端環境的訪客協作 」及 「管理 Microsoft Teams 中的帳戶與組織」。

如果你的任何帳號有訪客存取權,你不需要新增——它們會自動出現。 來賓是指團隊負責人邀請的外部成員,例如合夥人或顧問。 賓客的能力比團隊成員或團隊老闆少。

了解更多: 管理 Microsoft Teams 中的帳戶與組織

目前無法使用的功能及 Teams 中已知的 VDI 問題

  • 使用 WebRTC 優化的 AVD/W365 使用者若在虛擬桌面上Windows 11運行 24H2/25H2 (26100.6725 或更高) 且用戶帳號控制 (UAC) 關閉,則無法看到收到的視訊/螢幕分享。 目前解決此問題的解決方法要求管理員在 Windows 虛擬機上啟用 UAC。
  • Microsoft Teams 優化不支援巢狀或雙跳情境 (即從另一個虛擬桌面) 啟動第二個虛擬桌面。
  • 在某些情況下,Citrix RemotePC 使用者在使用 VDA 2411 並本地存取 Teams 時,可能會遇到 Teams 當機並重啟循環, (非透過 HDX) 。 詳情請參考CTX585013。
  • 即使使用 HotFix 4) ,Teams 在建立 FSLogix 個人檔案時也不會按需註冊 (,未來登入時也不會註冊,儘管已安裝。 程序生命週期管理器 (PLM) 服務與 AppxSvc 之間的競賽條件導致此問題。 導致更新套件時出現暫時性失敗,並帶有錯誤0x80004001 (E_NOTIMPL) 。 如果 PLM 服務沒有執行,Teams 註冊就會失敗。
    • (在 MSIX 中,註冊是以每位使用者為單位進行,從使用者登入時開始。 作業系統接著載入預先安裝的套件,並在開始選單中建立使用者專屬的應用程式資料、FTA 和應用程式磁貼。 此操作由 AppReadiness Service 執行,該服務知道所有預裝應用程式,並請求 Appx 部署服務 (AppxSvc 部署) 部署這些套件 )
    • 即使使用 FSLogix Hotfix 4,遇到此錯誤的客戶仍必須部署以下修正:
    • 這個錯誤已於 2024 年 5 月 Windows 10 (日 ) KB5037849中修正。 這個問題在 Windows 11 22H2 或更高版本就沒有。
  • Teams 無法啟動登入單用戶非持久化 Windows 10 虛擬桌面的使用者,或應用程式在開始選單中看不到。 但該應用程式可能會在登入後 15 分鐘內被看見並成功啟動。
    • 這個問題在Windows 10/11的KB5041582/KB5041587中都有說明,Teams 24215.1007.3082.1590 (或更高等級) ——這兩個元件都是必需的。
    • 例如,FSLogix 客戶可能需要從漫遊 (設定檔解決方案中排除以下地點,例如 redirections.xml) : AppData\Local\Packages\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\TempState
    • 注意 - 這個問題在多用戶的 Windows 10 或 11 中並不存在。 適用於 Windows 2019。 解決此問題的解決方案已提供: KB5044227
  • 客戶在黃金映像上安裝 Teams,之後再進行 sysprep 以泛化,卻無法啟動該應用程式。 此情況包含來自 Azure 圖片庫的範本。
    • 登入已配置虛擬機器的使用者會看到開始選單中的 Teams 圖示變成灰色,點擊它也沒有效果。
    • 事件檢視器 中的 AppX 日誌中有錯誤0x80073CF1。
    • 從升高的 PowerShell 視窗執行 Get-AppxPackage -name MsTeams -allusers 會顯示 PackageUserInformation 在 SID S-1-15-18 (LocalSystem) 處於 暫停狀態 。 這個錯誤在 W11 22H2 或更高版本上不會出現。 為 WS2022 安裝 Windows 10 KB5040437 KB5039299,以及 W11 21H2 的KB5040431
  • Azure虛擬桌面/Windows 365 (的聊天室螢幕分享 這個問題現在已在 RD 客戶端 1.2.5105 和 Redirector Service 1.50.2402.29001) 上修正。
  • 僅使用 Workspace 應用程式 2311 時,Citrix 聊天室的螢幕分享功能。
  • msteams_autostart.exe「參數錯誤」:在非持久環境中,使用 FSLogix (2210 HotFix 4) 或 Citrix Profile Manager 設定容器的任何版本,當 Teams 嘗試自動啟動或使用者嘗試從開始選單啟動 Teams 時,會跳出錯誤訊息:「參數不正確。」錯誤的頻率與可重現性會因環境而異,尤其是 SentinelOne、Palo Alto、Trend Micro、Bitdefender、CrowdStrike 等所使用的防毒軟體 () 及排除條款。 這個問題現在已經在 FSLogix 2210 HotFix 4 中修正。 遇到此問題的客戶必須升級至 CPM 2402 或 2203 CU5。
    • 「參數錯誤」錯誤可能由其他檔案系統驅動程式引起。 從升高的指令視窗執行 fltmc 會列出驅動程式。 兩個 Citrix 驅動程式 (UPMAction 和 upmjit) 也可能造成錯誤,即使你只使用 FSLogix HotFix 4 且沒有 Citrix Profile Manager。 此錯誤發生是因為 Citrix VDA 安裝程式通常預設安裝 profilemgt_x64.msi 以監控登入時間計數器。 移除那個 MSI 可以修正「參數錯誤」的錯誤。
  • Teams 無法啟動非持久虛擬桌面的使用者,或應用程式在開始選單 中無法 顯示。
    • 管理員不會遇到這個問題——在黃金映像上安裝 Teams 後,他們可以成功啟動。
    • 當你封存黃金映像並大規模部署後, (使用 Citrix MCS/PVS 或 Omnissa Instant-Clones) 等配置工具,使用者登入虛擬機器並點擊 Teams 圖示,但無法啟動應用程式。 問題源自於使用者層級對 MSIX 套件的註冊失敗, (2210 HotFix 4 之前的 FSLogix、Citrix CPM 2308 或 2311 但不支援 2402、Ivanti UEM 等,) ,儘管套件的暫存成功, (作業系統將套件內容儲存在磁碟上的 %ProgramFiles%\WindowsApps 目錄) 。 此問題可透過為受影響用戶執行 Get-AppxPackage -name MsTeams 來確認。 執行此程式碼會回傳空輸出。
    • 如果 Get-AppxPackage -name MsTeams -allusers 從 PowerShell 指令視窗執行,輸出顯示 Teams 已註冊 (看到 PackageFullName) 行,狀態為 OK
    • 這個問題在 FSLogix 2210 HotFix 4 中已經修正。
  • 當你使用 Azure 虛擬桌面或 Windows 365,以及 MAC 遠端桌面用戶端或 Windows 應用程式時,Microsoft Teams 介面不會列舉所有連接到裝置的周邊設備。 取而代之的是,只有在 macOS 層級選取的裝置會顯示在 Microsoft Teams 的裝置下拉選單中。 周邊設備有標籤。 「MAC 裝置名稱」+「喇叭」就是這種標籤的例子。
  • 從 Outlook 選擇連結時無法啟動 Teams 會議。 有驗證提示 (當使用者嘗試加入 外部 會議時,) 拒絕存取 '{tenant}' 租戶。 這個問題在 Teams 24091.214.2846.1452 中已修正。
  • PowerShell 視窗顯示的是 Teams 配置完成後。 如果虛擬機作業系統有正確的修補 (看到「 部署新的 Microsoft Teams 用戶端」,這是備忘錄區) 塊的第二個項目,管理員就可以刪除這個登錄檔鍵,PowerShell 視窗就不會再顯示了:
Location: "HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Run"
Name: TeamsProvisionRunKey

teamsbootstrapper.exe 版本 1.0.2407104 新增了這個 regkey,作為對缺乏這些修正的環境的權宜之計。

備註

Microsoft 正在研發解決方案,並計劃很快移除這些限制。

團隊的強化

VDI 中的網頁版 Teams

Teams for Web 在 VDI 環境中不被支援,因此若在 VDI 中使用,效能與可靠性可能會受到負面影響。

VDI 不支援的功能

以下功能在使用 WebRTC 優化時不支援 Teams。 這些限制大多已透過基於 SlimCore 的新優化得到解決。 欲了解更多資訊,請參閱我們 VDI 2.0 文章中 新優化 部分的功能清單。

  • QoS。

  • 1080p。

  • 使用者上傳的自訂背景。

  • Teams 進階版功能 (端對端加密、浮水印、高級活動未被優化,以及為組織) 自訂會議背景。

  • 虛擬人偶。

  • 圖庫視圖 3x3 和 7x7。

  • 除了 Virtual Desktop/W365 Azure Noise 抑制 (,因為 Teams 用戶端介面預設開啟了噪音抑制,但確認功能不會顯示。這種行為是設計出) 。

  • 放大/縮小。

  • 基於位置的路由。

  • 媒體旁通。

  • HID (Citrix 只有) 。

  • 僅) Omnissa (共享系統音訊。

  • 廣播及現場活動製作人及主持人職務。

  • 政府雲中的跨雲 (GCC、GCC High,以及由21Vianet運營的國防部) 與主權雲

  • 錄製影片片段 不會捕捉螢幕分享。

  • 通話監視器 (在你最小化 Teams 主視窗後,會出現一個小的浮動視窗) 不會顯示影片或螢幕分享。

  • 如果使用者從本地電腦啟動虛擬桌面,並登入 Teams (Azure Virtual Desktop/W365 和 Omnissa 同時支援 WebRTC 和 SlimCore,而 Citrix 則只用 SlimCore) ,Teams 通話會在該機器上斷線。

  • 主辦單位和演講者無法參加市政廳會議。