新しい Teams for Virtualized Desktop Infrastructure (VDI) へのアップグレード

[アーティクル]
04/13/2024
適用対象:

Microsoft Teams

この記事では、仮想化環境で新しい Microsoft Teams クライアントを使用する場合の要件と制限について説明します。

クラシック Teams for VDI の重要なお知らせ

クラシック Teams for VDI は、2024 年 6 月 30 日に可用性が終了します。詳細については、「クラシック Teams クライアントの可用性の終了」を参照してください。

その日付が過ぎると、ユーザーは従来の Teams を使用できなくなりますが、代わりに新しい Teams に切り替えるように求められます。今すぐ新しい Teams に更新することをお勧めします。

注意

VDI 用の新しい Teams は、パブリッククラウド、GCC、GCC High、DoD Government クラウドの顧客向けに一般提供されるようになりました。

要件

新しい Teams を正常にインストールするには、バージョン 23306.3314.2555.9628 以降が必要です。さらに、仮想マシンは、次に示す最小要件を満たす必要があります:

要件	バージョン
Windows	- Windows 10.0.19041 以降 - Windows Server 2019 (10.0.17763) - Windows Server 2022 (10.0.20348) 以降のWindows Server 2016はサポートされていません。アップグレードを計画する。 - Windows Server および Windows 10/11 マルチユーザー環境で必要な WebView2 フレームワーク
Webview2	最小バージョン: 90.0.818.66。詳細情報: WebView2 ランタイムのエンタープライズ管理
クラシック Teams アプリ	バージョン 1.6.00.4472 以降では、[新しい Teams を試す] トグルが表示されます。重要: クラシック Teams は、ユーザーが従来の Teams と新しい Teams を切り替えることができるようにする場合にのみ必要です。ユーザーに新しい Teams クライアントのみを表示する場合、この前提条件は省略可能です。
設定	システム>通知 Microsoft Teams の [通知バナーの表示] 設定を>オンにして、Teams 通知を受信します。
アプリサイドローディングが有効	インストールするすべてのコンピューターでサイドローディングが有効になっていることを確認します。詳細情報: Windows クライアントデバイスでの基幹業務 (LOB) アプリのサイドロード
ウイルス対策と DLP を除外する	Teams が正しく起動できるように、ウイルス対策アプリケーションと DLP アプリケーションに新しい Teams を追加します。詳細情報: ウイルス対策アプリケーションと DLP アプリケーションを Teams のブロックから除外する

仮想化プロバイダーの要件

現在、音声/ビデオ (AV) 最適化を備えた VDI 上の新しい Teams は、Azure Virtual Desktops、Windows 365、Citrix、VMware で認定されています。

このセクションの情報を確認して、適切に機能するためのすべての要件を満たしていることを確認してください。

Azure Virtual Desktop

Azure Virtual Desktop は、VDI 上の Teams に AV 最適化を提供します。詳細、要件およびインストールについては、「Azure Virtual Desktop で Microsoft Teams を使用する」を参照してください。

新しい Teams クライアントをサポートするには、次の最小バージョンが必要です:

Windows 1.2.1755 用リモートデスクトップクライアント
Mac 10.7.7 用リモートデスクトップクライアント
WebRTC リダイレクターサービス 1.1.2110.16001

Microsoft では、利用可能な最新バージョンを使用することをお勧めします。

さらに、新しい Teams クライアントを最適化するには、仮想デスクトップに次のレジストリキーをデプロイする必要があります。

HKLM\SOFTWARE\Microsoft\Teams:

名前: IsWVDEnvironment
型: DWORD
値: 1

Windows 365

Windows 365 は、Azure Virtual Desktop が提供する AV 最適化を使用して、クラウド PC からの最適な Teams エクスペリエンスを確保します。詳細、要件およびインストールについては、「クラウド PC で Teams を使用する」を参照してください。

ギャラリー内の Windows 10/11 イメージは、必要な最適化コンポーネントで事前構成されています。クラウド PC に Microsoft Teams をインストールして使用すると、最適化されたエクスペリエンスが得られます。新しい Teams クライアントを含む新しいイメージは、数週間後にギャラリーに追加されます。

Microsoft Teams の最適化を含むカスタムイメージを作成する場合は、「Microsoft Teams をサポートするためのカスタムクラウド PC イメージの作成」で説明されている手順を実行する必要があります。

新しい Teams クライアントをサポートするには、次の最小バージョンが必要です:

Windows 1.2.1755 用リモートデスクトップクライアント
Mac 10.7.7 用リモートデスクトップクライアント
Microsoft Store を使用した Windows の Windows 365 アプリ

さらに、新しい Teams クライアントを最適化するには、仮想デスクトップに次のレジストリキーをデプロイする必要があります。

HKLM\SOFTWARE\Microsoft\Teams:

名前: IsWVDEnvironment
型: DWORD
値: 1

Citrix Virtual Apps と Desktops と Citrix DaaS の要件

新しい Teams クライアントをサポートするには、次の最小バージョンが必要です:

Citrix ワークスペースアプリ:

Windows 2203 LTSR (および任意の CU)
Windows 2302 CR
Linux 2207
Mac 2302
Chrome/HTML5 2301

Citrix Virtual Delivery Agent (VDA):

2203 LTSR (および任意の CU)
2212 CR
1912 CU6 (ただし、最新の CU が推奨されます - 1912 ではアプリ共有がサポートされていないことに注意してください)

さらに、新しい Teams クライアントを最適化するには、VDA に次のレジストリキーをデプロイする必要があります。

場所: HKLM\SOFTWARE\WOW6432Node\Citrix\WebSocketService
キー (REG_Multi_SZ): ProcessWhitelist
値: msedgewebview2.exe

このレジストリキーが見つからない場合、新しい Teams クライアントは最適化されていないモード (サーバー側レンダリング) で動作します。 VDA 2402 を使用している場合は、この regkey は不要です (詳細については、こちらをチェックしてください)。

注意

Citrix Virtual Apps (発行済みアプリとも呼ばれます) は現在、VDA 2402 LTSR でサポートされています。

詳細については、「 Microsoft Teams の最適化」を参照してください。

VMware Horizon とワークスペース ONE の要件

新しい Teams クライアントをサポートするには、次の最小バージョンが必要です:

Horizon 8 2111 ESB (8.4)

Teams のメディア最適化を構成する方法に関する最新の要件と手順を入手するには、「Microsoft Teams のメディア最適化の構成」を参照してください。

新しい Microsoft Teams クライアントを展開する

新しい Microsoft Teams クライアントを組織に展開するには、次のいずれかのオプションを選択します。

Important

最新バージョンの bootstrapper.exe を使用する必要があります。以前に .exe をダウンロードした場合は、バージョンの [プロパティ] > [詳細] > [製品のバージョン] を表示して最新バージョンがあることを確認し、最新のダウンロードのプロパティと比較します。

注意

これらの KB は、新しい Teams のダウンロードとインストールを制限する多くのポリシー設定に対処するため、システム内にこれらの KB があることを確認します。

Windows 10または 11 を使用している場合は、KB5031455をインストールしていることを確認します。それ以外の場合は、GPO AllowAllTrustedApps が false に設定されていて、この記事の「新しい Teams で VDI で現在使用できない既知の問題」セクションに記載されている問題が発生する可能性があります (非永続的な仮想デスクトップにログインしたユーザーに対して新しい Teams が起動できない場合、またはアプリがスタートメニューに表示されない場合)。
GPO BlockNonAdminUserInstall が true に設定されている場合、「新しい Teams で VDI で現在利用できない、既知の問題」セクションに記載されている問題が発生する可能性があります (非永続的な仮想デスクトップにログインしているユーザーに対して新しい Teams が起動できないか、スタートメニューにアプリが表示されない)。 OS に対応する KB があることを確認します。

KB5035942 (Windows 11 バージョン 22H2 および 23H2、すべてのエディション)
KB5035941 (任意のバージョン、すべてのエディションWindows 10)
KB5036909 (Windows Server 2022)

オプション 1: 従来の Teams クライアントをアンインストールし、新しいクライアントをインストールする

VDI で新しい Teams をデプロイするための推奨される方法。 このオプションには、直接または "一括デプロイ" メソッドが使用されます。詳細については、「新しい Microsoft Teams デスクトップクライアントを一括デプロイする」を参照してください。

teamsbootstrapper.exe -p コマンドを使用すると、常に最新の新しい Teams クライアントがインストールされます。

段階的かつ制御されたロールアウトは、新しいコンピューターカタログ/配信グループの割り当てをより多くのユーザーに選択的に拡張することで実現できます。

管理者は、ローカルチームの MSIX を使用して新しい Teams をプロビジョニングすることもできます。このオプションは、初期インストールに使用される帯域幅の量を最小限に抑えます。 MSIX は、ローカルパスまたは UNC に存在できます。

.exe インストーラーをダウンロードします。
MSIX:
- MSIX x86
- MSIX x64
- ARM64 をダウンロードします。
管理者としてコマンドプロンプトを開きます。
MSIX の場所に応じて、次の手順を実行します:

ローカルパスとして、.\teamsbootstrapper.exe -p -o "c:\path\to\teams.msix" と入力します。

例:

オフラインインストーラーのローカルパスの場所

UNC の場合は、.\teamsbootstrapper.exe -p -o "\unc\path\to\teams.msix" と入力します。

例:

unc を使用したオフラインの場所

オプション 2: 両方のアプリを "並べて" インストールする

Teams UI の左上にあるトグルを使用して、ユーザーが切り替えることができます。 Teams 管理センターポリシー Teams 更新ポリシーを構成することで、トグルを表示するユーザーを制御できます。

切り替えが新しい Teams クライアントのロールアウトに使用されている場合、管理者は VDI 環境が「新しい Teams クライアントでのインストールの問題のトラブルシューティング」で説明されている最小要件を満たしていることを確認する必要があります。

IT 管理者が MSIX の制限を設定したり GPO を展開したりすると、ユーザーがアプリをダウンロードしてインストールできなくなる可能性があります。制限が設定されている場合、ユーザーは次のようなエラーを表示する可能性があります:

組織ポリシーのエラー

Important

"サイドバイサイド" メソッドは、永続的な環境でのみサポートされます。クラシック Teams 1.7.00.7956 以降では、クラシック Teams が非永続的な環境で実行されている場合、クラシック Teams MSI、C:\Program Files (x86) のインストールフォルダーに基づいて非永続的が検出される場合、Teams 管理センターポリシー値に関係なく、アプリ切り替え切り替えが抑制されます。

クラシック Teams と VDI 環境の新しい Teams インストーラー

従来の Teams クライアントと新しい Teams クライアントには、インストール場所とプロファイル管理の要件が異なります。違いを理解し、それに応じて計画することが重要です。

インストーラー形式	インストール場所	自動更新
ALLUSERS=1 フラグを持つクラシック Teams MSI	C:\Program Files (x86)\Microsoft\Teams	無効
クラシック Teams .EXE	%localappdata%/Microsoft/Teams	有効
新しい Teams .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 エラーコードに依存できます。エラーコードで十分な情報が提供されない場合は、詳細なイベントログに詳細な診断情報が表示されます。

イベントビューアー (ローカル) > アプリケーションとサービスログ > Microsoft > Windows に移動します。
次のカテゴリで使用可能なログを確認します。

AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
AppXDeployment-Server > Microsoft-Windows-AppXDeploymentServer/Operational

AppXDeployment-Server の下のログを確認する

詳細情報: 一般的なエラーコード

Windows Server 2019 のインストール手順

Windows Server 2019 の場合、サポートされているインストール方法は次だけです:

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

サイドローディングが有効になっていて、WebView2 がインストールされていることを確認します。上記の「要件」セクションを参照してください。

/SkipLicense コマンドは、MSIX パッケージが "ストアパッケージ" とは見なされないため (ストアからダウンロードされていないため) 必要です。したがって、Dism インストールコマンドを成功させるためには、インストール時にもこのポリシーを有効にする必要があります。コンピューター構成 > 管理テンプレート > Windows コンポーネント > アプリパッケージの展開 >信頼されているすべてのアプリのインストールを許可します。

既知の制限:

クラシック Teams のバージョンが 1.6.00.33567 より低い場合、Windows Server 2019 のクラシック Teams にアプリスイッチャーの切り替えが表示されません
Windows Server 2019 の新しい Teams は現在、FSLogix と互換性がありません。起動に失敗します。詳細については、「 FSLogix の既知の問題」を参照してください。

Windows Server 2019 での新しい Teams との Outlook プレゼンスの統合

Outlook でプレゼンス状態を適切に表示するには、ゴールデンイメージで次の手順が必要です。

マシン全体 (ALLUSERS=1) 'Windows 10 1809 および Windows Server 2019 KB5035849 240209_02051 機能 Preview.msi' をインストールします。
グループポリシーエディターを開きます。コンピューターの構成\管理用テンプレート\KB5035849 240209_02051 機能プレビュー\Windows 10 Version 1809と Windows Server 2019 に移動します。その設定の値を [有効] に変更します。
Microsoft Update Catalog または WSUS for Enterprises から 2024 年 3 月の累積的な更新プログラムKB5035849インストールします。
マシン全体 (ALLUSERS=1) 'MSTeamsNativeUtility.msi' をインストールします。
仮想マシンを再起動します。
上記のセクションで説明したように Dism を使用して、新しい Teams 24033.811.2738.2546 以降をインストールします。

注意

手順 1、2、3、4、5 は 1 回だけ必要です。それ以降のゴールデンイメージメンテナンスでは、これらの手順を繰り返す必要はありません。

Important

プレゼンスを正しく表示するには、新しい Teams を起動した後に Outlook を起動する必要があります。

すべてのユーザーの新しい Teams を削除する

すべてのユーザーの新しい Teams をアンインストールしてプロビジョニング解除するには、次のコマンドを使用します:

./teamsbootstrapper -x

このコマンドは、すべてのユーザーの新しい Teams の登録を解除し、プロビジョニングを解除します。 Teams ユーザープロファイル/キャッシュが削除されます。

新しい Teams の自動更新を無効にする

新しい Teams の自動バックアップを防ぐには、仮想マシンで次のレジストリキーを使用します。このレジストリキーを処理できるのは、VDI の 23306.3314.2555.9628 より高い新しい Teams ビルドのみです。

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

新しい 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 には、Teams アプリ切り替え切り替えのユーザー構成 (および既定のアプリであるクラシックまたは新しい Teams)、および Teams 会議アドイン for Outlook が格納されます。

TeamsSharedConfig の下のフォルダー "meeting-addin" は保持しないでください。これにより、Outlook に挿入された会議テンプレートの既定の会議座標に問題が発生する可能性があるためです。

Important

FSLogix を使用しているお客様は、VDI の新しい Teams クライアントとの適切な統合を保証するために、修正プログラム 2.9.8784.63912 をインストールする必要があります。修正プログラムは、次の問題に対処します。

非永続的なマルチユーザー環境では、新しい Teams の更新後に一部のユーザーに対して新しい Teams の登録を解除できます
ユーザーのサインアウト中に、%LocalAppData%\Packages\MSTeams_8wekyb3d8bbwe\LocalCache にある新しい Teams クライアントユーザーデータ/キャッシュは、FSLogix プロファイルまたは ODFC コンテナーに 保存されませんでした 。

注: プロファイルと ODFC コンテナー、または ODFC コンテナーのみを使用しているお客様は、新しい Teams ユーザーデータ/キャッシュを保持するための設定 'IncludeTeams' を追加する必要があります。

注意

フォルダーリダイレクトまたは移動ユーザープロファイルは、VDI 環境の新しい Teams クライアントではサポートされていません。これは、AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams 内のフォルダーをローミングできないためです。お客様は、上記の Appdata\Local フォルダーをローミングできる FSLogix、Citrix Profile Manager、VMware、DEM などの補完的な製品で、フォルダーリダイレクトまたは移動ユーザープロファイルを引き続き使用できます。

フォルダーの除外

ディスクストレージの使用状況

新しい Teams アプリは、クラシックバージョンよりも約 50% 少ないディスク領域を占有します。クライアントを Windows デバイスに配布しやすくするために、MSIX のサポートが追加されました。これにより、インストールとアプリの更新プログラムの信頼性が向上し、ネットワーク帯域幅とディスク領域の消費が削減されます。このパッケージ化テクノロジは、正確なディスク領域の使用量も示します。 Windows の設定では、従来の Teams よりもディスク使用量が大きくなる場合がありますが、違いは主に、Electron ベースのクラシック Teams に関連するディスク領域が完全かつ正しく表示されていないためです。

ディスクフットプリント - キーフォルダーと場所

アプリインストーラー: C:\Program Files\WindowsApps\MSTeams_[version]_[arch]__8wekyb3d8bbwe インストールパッケージが含まれており、アプリをリセットする機能をサポートし、単一インスタンス化を許可します。
ユーザーとアプリのデータ: C:\Users<alias>\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe これには、コード (Javascript バンドル)、コードキャッシュ、ブラウザーキャッシュ、ユーザーデータのデータベース (使用状況に基づいてスケーリングされる会話など)、Web ストレージ (Sharepoint、Viva 学習、アプリなど、Teams 内でホストされているドメインからの) が含まれます。

基になるフォルダー構造は、電子ベースのクラシック Teams と論理的に似ています。記憶域フットプリントが考慮される非永続的なセットアップの場合は、次のガイダンスが適用されます。

除外に推奨

フォルダー	フォルダーパス	役割	除外の影響
ログ	LocalCache\Microsoft\MSTeams\Logs LocalCache\Microsoft\MSTeams\PerfLog	診断、パフォーマンスログなど。	影響はありません。
WebStorage	LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ WebStorage	iframe を使用して Web アプリ内の他の Web アプリにアクセスするときに、ブラウザーによって使用および管理されるストレージ。たとえば、Teams 内で Sharepoint、OneDrive、Office アプリを読み込むなどです。	このキャッシュをクリアすると、これらのアプリの読み込みが遅くなる可能性があります。
GPU キャッシュ	LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ GPUCache	GPU キャッシュ。	影響はありません。

トレードオフに関する考慮事項を確認し、これらの環境の評価とテストを必要とする

フォルダー	フォルダーパス	役割	除外の影響
サービスワーカー	LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ Service Worker\CacheStorage LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\Code Cache	アプリを実行するための Web/JS スクリプトのコードとキャッシュ。	- すべてのアプリ起動時にスクリプトをダウンロードして読み込むためのパフォーマンスの低下 - アプリへのオフラインアクセスなし
Indexeddb	LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\IndexedDB	アプリとユーザーのデータを保持し、Web アプリで大規模にデータをキャッシュして応答性を向上させる推奨される方法です。	- データ (チャットやチャネルの会話など) のアプリ起動時間が大幅に長く、毎回ダウンロードしてキャッシュする必要があるデータとしてのネットワーク使用量と共にプルダウンする必要があります。 - データのサイズは、ユーザープロファイルによって異なります。 - ユーザーには、起動スプラッシュ画面に設定が表示される場合があります。
キャッシュ	LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\Cache	アプリを離れるすべてのネットワーク呼び出しの内容に対してブラウザーによって使用および管理されるキャッシュ。ディスクキャッシュとも呼ばれます。	たとえば、Teams のプロファイル画像は、ほとんどの場合、ブラウザーによってこのストレージにキャッシュされます。これらはもう一度ダウンロードする必要があります。

このセクションのフォルダー以外に、追加のディレクトリを除外することはお勧めしません。

新しい Teams と Outlook の統合

[設定] > [全般] > [システム] で [新しい Teams を Microsoft 365 のチャットアプリとして登録する] チェックボックスがオンになっている場合、新しい Teams クライアントは、インスタントメッセージ機能 (プレゼンス、チャット、VOIP など) を持つすべての Microsoft 365 アプリと統合できます。

たとえば、Outlook では、既定の IM クライアントアプリケーションと統合するために、ここで説明する検出プロセスを実行します: IM アプリケーションと Office の統合

注意

クラシック Teams がインストールされていない仮想マシンに新しい Teams がインストールされている場合は、Outlook とプレゼンスとの適切な統合を保証するために、新しい Teams バージョン 23320.3021.2567.4799 以降を使用していることを確認する必要があります。

Teams 会議アドイン

さらに、新しい Teams MSIX パッケージには、Teams 会議アドイン (または TMA) MSI ("MicrosoftTeamsMeetingAddinInstaller.msi") がバンドルされています。 TMA を使用すると、Outlook から Teams 会議をスケジュールできます。

TMA と Outlook クライアントの統合に関連するセキュリティに関する記事については、 Outlook クライアントを使用する場合の Teams 会議アドインのセキュリティに関する記事を参照してください。

コンピューターにインストールされているすべての新しい Teams ファイルが署名されているため、IT 管理者は AppLocker/Code Integrity/Windows Defender Application Guard ポリシーを使用して、それを適用するように構成できます。

TMA の新しい Teams のユーザーごとのインストールの場合、インストールフォルダーは AppData\Local\Microsoft\TeamsMeetingAddin にあります
新しい Teams バージョン 24060.2623.2790.8046 以降では、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」というエラーが表示される場合があります。

このエラーは、Windows インストーラーに影響を与える GPO によって発生します。これには、パブリッシャールールの条件に基づく DisableUserInstalls、 DisableMSI、AppLocker ポリシー、MSI インストールの RuleCollection が含まれます。この場合は、次のような例外を作成する必要があります。

FilePathCondition Path="%PROGRAMFILES%\WINDOWSAPPS*\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI"

回避策：新しい Teams インストールディレクトリにある 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
```
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\"

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 new Teams Package
if (-not ($NewTeamsPackageVersion = (Get-AppxPackage -Name MSTeams).Version)) {
    Write-Host "New Teams Package not found. Please install new Teams from https://aka.ms/GetTeams ."
    exit 1
}
Write-Host "Found new 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\TeamsMeetingAddin\{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 が削除され、新しい Teams のみがインストールされている場合、Teams 会議アドイン MSI は HKCU の下に 3 つのレジストリキーを作成できず、会議アドインが正しく読み込めなくなる可能性があります。

これらのキーは、追加のサインインスクリプトまたは同様の方法を使用してデプロイする必要があります。

新しい Teams 会議アドイン

注意

これらの HKCU レジストリキーは、新しい Teams 24060.2623.2790.8046 以降をインストールする場合は不要です。これはバージョン 1.0.24054.1 TeamsMeetingAddIn.msi バンドルされているため、HKCU でのレジストリキーの作成が成功するための修正が含まれています。

新しい Teams と Outlook の統合のトラブルシューティング

症状

Outlook でユーザーのプレゼンス状態を確認すると、次のいずれかの問題が発生します:

プレゼンスインジケーターは表示されていません。
表示されているプレゼンスが正しくありません。
プレゼンスの状態は状態不明です。

トラブルシューティングの手順

新しい Teams が実行されていることを確認します。次に、Outlook を起動します。
コンピューターのレジストリ設定を確認して、新しい Teams が既定のインスタントメッセージング (IM) アプリとして登録されていることを確認します。

a. レジストリエディターを起動します。 b. 次のサブキーを見つけます:

- HKEY_CURRENT_USER\Software\IM Providers

c. 次の値を確認します:

- **Name:** DefaultIMApp
- **Type:** REG_SZ
- **Data:** MsTeams (If you see Teams, it means classic Teams is still the default IM app)

次のサブキーを見つけます:

HKEY_CURRENT_USER\Software\IM Providers\MsTeams (Outlook は、このレジストリキーの値の変更を監視します)

次の値を確認します:

-Name: UpAndRunning -Type: REG_DWORD -Data: 2 (0- Not running, 1— Starting, 2—Running)

問題が解決しない場合は、Microsoft サポートにお問い合わせください。

Teams でフォールバックモードを制御する

ユーザーがサポートされていないエンドポイントから接続すると、ユーザーはフォールバックモードになり、オーディオ/ビデオは最適化されません。次のレジストリ DWORD 値のいずれかを設定して、フォールバックモードを無効または有効にできます。

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

フォールバックモードを無効にするには、値を 1 に設定します。
音声のみを有効にするには、値を 2 に設定します。
値が存在しない場合、または 0 (ゼロ) に設定されている場合は、フォールバックモードが有効になります。
フォールバックでは、画面共有機能は別のスクリーンピッカー UI でサポートされています (ユーザーが Teams for Web で表示するエクスペリエンスと同様)。

VDI でのマルチテナントとマルチアカウント

VDI の Teams の新しいバージョンでは、すばやく簡単にサインインでき、同じ Microsoft 365 クラウド環境から複数のアカウントと組織を切り替えることができます。

いずれかのアカウントが他の組織にゲストアクセスできる場合は、追加する必要はありません。自動的に表示されます。ゲストとは、パートナーやコンサルタントなど、チーム所有者がチームに参加するように招待するorganizationの外部からのユーザーです。ゲストの機能は、チームメンバーまたはチーム所有者よりも少なくなります。

詳細情報: Microsoft Teams でアカウントと組織を管理する

新しい Teams での VDI で現在利用できない機能と既知の問題

Azure Virtual Desktops/Windows 365 のチャットからの画面共有 (この問題は、RD クライアント 1.2.5105 およびリダイレクターサービス 1.50.2402.29001 で修正されました)。
ワークスペースアプリ 2311 のみを使用する場合の Citrix のチャットからの画面共有。
仮想マシンにマシン全体のクラシック Teams がインストールされている場合 (MSI が ALLUSERS=1 の場合)、アプリスイッチャーの切り替えは新しい Teams に表示されません。注: この問題は、新しい Teams バージョン 23320.3021.2567.4799 以降で修正されています。
msteams_autostart.exe "パラメーターが正しくありません": FSLogix (任意のバージョン) または Citrix Profile Manager プロファイルコンテナーを使用する非永続的な環境では、新しい Teams が自動開始しようとすると、またはユーザーが [スタート] メニューから Teams を起動しようとすると、"パラメーターが正しくありません" というエラーがスローされます。エラーの頻度と再現性は、環境、特に使用されているウイルス対策ソフトウェア (SentinelOne、Palo Alto、Trend Micro、Bitdefender、CrowdStrike など) と除外によって異なります。
非永続的な仮想デスクトップにログインしているユーザーに対して新しい Teams の起動が失敗するか、スタートメニューにアプリが表示 されません 。
- 管理者はこの問題を経験しません。ゴールデンイメージに新しい Teams をインストールすると、正常に起動できます。
- ゴールデンイメージをシールして大規模にデプロイした後 (Citrix MCS/PVS や VMware Instant-Clones などのプロビジョニングツールを使用)、ユーザーは仮想マシンにログインし、新しい Teams アイコンをクリックしますが、アプリを起動できません。この問題は、パッケージのステージングが成功した (OS がパッケージの内容を %ProgramFiles%\WindowsApps ディレクトリに格納した) 場合でも、異なるプロファイル管理ソフトウェア (FSLogix、Citrix CPM、Ivanti UEM など) を使用したユーザーレベルでの MSIX パッケージの登録が失敗したことが原因で発生します。この問題は、影響を受けるユーザー Get-AppxPackage MsTeams という名前を実行することで確認できます。このコードを実行すると、空の出力が返されます。
- Get-AppxPackage -name MsTeams -allusers が管理者特権の powershell コマンドウィンドウから実行された場合、出力は Teams が登録されていることを示し (行 PackageFullName を参照)、状態は OK です。

注意

Microsoft はソリューションに取り組んでおり、近いうちにこれらの制限を削除する予定です。

新しい Teams の機能強化

クラシック Teams の問題は、新しい Teams で修正されました。

マルチテナントマルチアカウント。
ハードウェアリソースの消費量のパフォーマンスの向上。
チャネル 2.0。
[再起動] を求めずに、マルチウィンドウが既定で有効になっています。
共有ツールバーの機能強化 (ピン留め/固定解除を含む)。

クラシック Teams と新しい Teams の VDI 機能の比較

従来の Teams クライアントで動作するすべてのマルチメディア機能は、新しい Teams クライアントで動作することが期待されます。特定の機能マトリックスについては、VDI プロバイダー Web サイトをチェックします。

プロバイダー	詳細
Azure Virtual Desktops と Windows 365	Azure Virtual Desktop 上の Microsoft Teams でサポートされている機能
Citrix	Microsoft Teams の最適化
VMware	Horizon 7 および Horizon 8 の最近のリリースの MS Teams 最適化機能互換性マトリックス。 (86475) (vmware.com)

VDI の Web 用の新しい Teams

新しい Teams for Web は VDI 環境ではサポートされていないため、VDI で使用する場合、パフォーマンスと信頼性に悪影響が及ぶことがあります。

VDI でサポートされていない機能

次の機能は、従来の Teams または新しい Teams ではサポートされていません。

Qos。
1080p。
ユーザーがアップロードしたカスタム背景。
Teams Premium機能 (エンドツーエンドの暗号化、透かし、Premium イベントは最適化されていません、組織向けのカスタム会議の背景)。
アバター。
ギャラリービュー 3x3 および 7x7。
ノイズ抑制 (既定ではノイズ抑制がオンになっている AVD/W365 を除くが、確認は Teams クライアント UI には表示されません。これは仕様です)。
拡大/縮小します。
場所ベースのルーティング。
メディアバイパス。
HID (Citrix のみ)。
システムオーディオ (Citrix と VMware) を共有します。
ブロードキャストおよびライブイベントプロデューサーと発表者ロール。
Government Cloud (GCC、GCC High、DoD) でのクロスクラウド匿名参加。
ビデオクリップを録画 しても、画面共有はキャプチャされません。
通話モニター (メイン Teams ウィンドウを最小化した後の小さなフローティングウィンドウ) には、ビデオまたは画面共有が表示されません。
ユーザーがそのローカルコンピューターから仮想デスクトップを起動し、Teams にログインすると、Teams 通話はローカルコンピューターにドロップされます (AVD/W365 と VMware のみ)。

新しい Teams for Virtualized Desktop Infrastructure (VDI) へのアップグレード

クラシック Teams for VDI の重要なお知らせ

要件

仮想化プロバイダーの要件

Azure Virtual Desktop

Windows 365

Citrix Virtual Apps と Desktops と Citrix DaaS の要件

VMware Horizon とワークスペース ONE の要件

新しい Microsoft Teams クライアントを展開する

オプション 1: 従来の Teams クライアントをアンインストールし、新しいクライアントをインストールする

オプション 2: 両方のアプリを "並べて" インストールする

クラシック Teams と VDI 環境の新しい Teams インストーラー

新しい Teams 展開エラーのトラブルシューティング

Windows Server 2019 のインストール手順

Windows Server 2019 での新しい Teams との Outlook プレゼンスの統合

すべてのユーザーの新しい Teams を削除する

新しい Teams の自動更新を無効にする

新しい Teams クライアントのプロファイルとキャッシュの場所

フォルダーの除外

ディスクストレージの使用状況

ディスクフットプリント - キーフォルダーと場所

除外に推奨

トレードオフに関する考慮事項を確認し、これらの環境の評価とテストを必要とする

新しい Teams と Outlook の統合

Teams 会議アドイン

新しい Teams と Outlook の統合のトラブルシューティング

症状

トラブルシューティングの手順

Teams でフォールバックモードを制御する

VDI でのマルチテナントとマルチアカウント

新しい Teams での VDI で現在利用できない機能と既知の問題

新しい Teams の機能強化

クラシック Teams と新しい Teams の VDI 機能の比較

VDI の Web 用の新しい Teams

VDI でサポートされていない機能

フィードバック

フィードバック

その他のリソース

新しい Teams for Virtualized Desktop Infrastructure (VDI) へのアップグレード

クラシック Teams for VDI の重要なお知らせ

要件

仮想化プロバイダーの要件

Azure Virtual Desktop

Windows 365

Citrix Virtual Apps と Desktops と Citrix DaaS の要件

VMware Horizon とワークスペース ONE の要件

新しい Microsoft Teams クライアントを展開する

オプション 1: 従来の Teams クライアントをアンインストールし、新しいクライアントをインストールする

オプション 2: 両方のアプリを "並べて" インストールする

クラシック Teams と VDI 環境の新しい Teams インストーラー

新しい Teams 展開エラーのトラブルシューティング

Windows Server 2019 のインストール手順

Windows Server 2019 での新しい Teams との Outlook プレゼンスの統合

すべてのユーザーの新しい Teams を削除する

新しい Teams の自動更新を無効にする

新しい Teams クライアントのプロファイルとキャッシュの場所

フォルダーの除外

ディスク ストレージの使用状況

ディスク フットプリント - キー フォルダーと場所

除外に推奨

トレードオフに関する考慮事項を確認し、これらの環境の評価とテストを必要とする

新しい Teams と Outlook の統合

Teams 会議アドイン

新しい Teams と Outlook の統合のトラブルシューティング

症状

トラブルシューティングの手順

Teams でフォールバック モードを制御する

VDI でのマルチテナントとマルチアカウント

新しい Teams での VDI で現在利用できない機能と既知の問題

新しい Teams の機能強化

クラシック Teams と新しい Teams の VDI 機能の比較

VDI の Web 用の新しい Teams

VDI でサポートされていない機能

フィードバック

フィードバック

その他のリソース

ディスクストレージの使用状況

ディスクフットプリント - キーフォルダーと場所

Teams でフォールバックモードを制御する