UWPアプリが正常にインストールされていない事象の調査

目次

本記事はマイクロソフト社員によって公開されております。

こんにちは。 Windows Performance チームの栗木です。 本ブログでは、UWP アプリ(設定、電卓、付箋、フォト等)が正常にインストールされていない事象が発生した場合に採取いただきたい資料についてご紹介いたします。

情報採取スクリプトファイルの取得について

以下の URL より “TSS.zip” をダウンロードおよび展開いただき、対象端末へ配置します。

ダウンロード先: https://aka.ms/getTSS

※ TSS は機能の拡張などにより内容が変更されることがあります。そのため、毎回上記のダウンロード先から TSS を取得いただき使用してください。
※ 2024年7月8日以降ツールの入手方法の変更が計画されています。該当 URL にアクセスできない場合、サポート リクエストを発行の上、担当エンジニアまでご連絡ください。

資料採取手順

  1. UWP アプリが正常にインストールされていない事象が発生しているユーザーで端末にログインします。

  2. 管理者としてPowerShell を起動し、以下のコマンドより、スクリプトの実行を許可します。

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
    
  3. TSSを展開したパスに移動します。

    cd "C:\path\to\TSS"
    
  4. 以下のコマンドを実行し、資料採取を開始します。

    .\TSS.ps1 -Start -PRF_AppX -UEX_COM -Procmon -BasicLog -PSR -LogFolderPath "C:\MS_DATA"
    

    画面の指示にそって進み、以下のメッセージが出力されるまで待ちます。
    Reproduce the issue and enter ‘Y’ key AFTER finishing the repro (with window focus here) [Y]?

  5. 管理者権限ではない PowerShell を別に起動し、該当のアプリを以下のコマンドにより、インストールします。

    Add-AppxPackage -Register "C:\Windows\SystemApps\MicrosoftWindows.Client.CBS_cw5n1h2txyewy\AppXManifest.xml" -DisableDevelopmentMode -ForceApplicationShutdown
    

    Add-AppxPackage: https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage

    この例では、Client.CBS をインストールしています。他のアプリをインストールする場合は、各アプリのインストール パスを参考にコマンドを変更してください。

  6. 管理者として起動していた PowerShell に戻り、 ‘Y’ を入力し、資料採取を終了します。

  7. C:\MS_DATAフォルダに資料(Zipファイル)が出力されておりますので、弊社へご提供ください。

各アプリのインストール パス

  1. 管理者としてPowerShell を実行し、作業用のフォルダにインストールされているアプリのリストを出力します。

    md "c:\temp"
    Get-AppxPackage -alluser > "c:\temp\appx-alluser.txt"
    

    Get-AppxPackage: https://learn.microsoft.com/en-us/powershell/module/appx/get-appxpackage

  2. 出力した appx-alluser.txt から確認したいアプリの InstallLocation を確認します。 以下に代表的なアプリの例をご紹介します。なお、アプリのバージョンよって InstallLocation は異なります。

    Name : Microsoft.Windows.Photos (フォト)
    InstallLocation : C:\Program Files\WindowsApps\Microsoft.Windows.Photos_2022.31120.6008.0_x64__8wekyb3d8bbwe

    Name : Microsoft.WindowsCalculator (電卓)
    InstallLocation : C:\Program Files\WindowsApps\Microsoft.WindowsCalculator_11.2210.0.0_x64__8wekyb3d8bbwe

    Name : Microsoft.Paint (ペイント)
    InstallLocation : C:\Program Files\WindowsApps\Microsoft.Paint_11.2210.4.0_x64__8wekyb3d8bbwe

  3. InstallLocation にある AppxManifest.xml を指定して、Add-AppxPackage コマンドを実行することにより、該当のアプリをインストールできます。

    Add-AppxPackage -Register "<InstallLocation>\AppxManifest.xml" -DisableDevelopmentMode -ForceApplicationShutdown
    

    フォトの例

    Add-AppxPackage -Register "C:\Program Files\WindowsApps\Microsoft.Windows.Photos_2022.31120.6008.0_x64__8wekyb3d8bbwe\AppxManifest.xml" -DisableDevelopmentMode -ForceApplicationShutdown