パッケージサポートフレームワークファイルシステム書き込みアクセス許可エラーを修正する方法

[アーティクル]
07/11/2023

この記事では、パッケージサポートフレームワーク (PSF) を使用して、ファイルシステム書き込みアクセス許可エラーを解決する方法について説明します。

Windows アプリは、特定のアプリケーション関連のディレクトリをフォルダーに C:\Program Files\WindowsApps リダイレクトします。アプリケーションが Windows アプリコンテナーに書き込もうとすると、エラーがトリガーされ、書き込みが失敗します。この問題を解決するために、Windows アプリパッケージの機能強化を行うことができます。

調査

まず、エラーと、アプリが要求しているディレクトリパスを特定します。

Windows アプリのエラーをキャプチャする

結果のフィルター処理は省略可能ですが、アプリケーション関連のエラーを簡単に確認できます。結果をフィルター処理するには、2 つのフィルター規則を作成します。最初のフィルターにはアプリケーションプロセス名が含まれており、2 番目のフィルターには成功しなかった結果が含まれます。

SysInternals プロセスモニターをダウンロードし、C:\PSF\ProcessMonitor ディレクトリに抽出します。
Windows エクスプローラーを開き、抽出した SysInternals ProcessMonitor フォルダーに移動します。
SysInternals プロセスモニター procmon.exe ファイルを選択して、アプリを起動します。
UAC でメッセージが表示されたら、[ はい] を選択します。
[ プロセスモニターフィルター ] ウィンドウで、最初のフィールドのドロップダウンメニューから [ プロセス名 ] を選択します。
が次のフィールドに表示されることを確認します。
次のフィールドに、アプリのプロセス名を入力します (例: PSFSample.exe)。
[追加] を選択します。
[ プロセスモニターフィルター ] ウィンドウで、最初のフィールドのドロップダウンメニューから [ 結果 ] を選択します。
次のフィールドで、がドロップダウンメニューから 選択されていません 。
テキストフィールドに「SUCCESS」と入力 します。
**[追加]** 、 **[OK]** の順に選択します。
Windows アプリを起動し、エラーをトリガーして、Windows アプリを閉じます。

Windows アプリのエラーログを確認する

Windows アプリプロセスをキャプチャした後、結果を調査して、エラーが作業ディレクトリに関連しているかどうかを判断します。

SysInternals プロセスモニターのエラー結果を確認します。 C:\Program Files\WindowsApps\...\を対象とするアプリに対して[アクセス拒否]、[Desired Access: Generic Write detail]\(必要なアクセス: 汎用書き込み詳細\) が結果に含まれている場合は、作業ディレクトリに関連する書き込みアクセス許可エラーが特定されました。

SysInternals プロセスモニターで、ディレクトリへの書き込みに失敗した場合に監視されるエラーメッセージを表示します。

このエラーが特定された場合は、次の PSF 修正をアプリに適用します。

解決方法

Windows アプリが Windows アプリコンテナーへの書き込みに失敗する問題を解決するには、次の手順に従います。

Windows アプリのコンテンツをローカルのステージングディレクトリに抽出します。
config.json を作成し、PSF fixup ファイルをステージングされた Windows アプリディレクトリに挿入します。
PSF ランチャーを指すアプリケーション起動ツールを構成し、PSF ランチャーをリダイレクトするように PSF config.json ファイルを構成し、作業ディレクトリを指定します。
Windows アプリ AppxManifest ファイルを更新します。
Windows アプリを再パッケージ化して署名します。

必要なツールをダウンロードしてインストールする

このプロセスには、次のツールが必要です。

NuGet クライアントツール
パッケージサポートフレームワーク (PSF)
Windows 10 ソフトウェア開発ツールキット (Win 10 SDK)、最新バージョン
SysInternals プロセスモニター

NuGet と PSF をダウンロードしてインストールするには:

NuGet クライアントツールの最新のプレビュー以外のバージョンをダウンロードし、nuget.exeを C:\PSF\nuget に保存します。
管理 PowerShell ウィンドウから次のコマンドを実行して、NuGet を使用してパッケージサポートフレームワークをダウンロードしてインストールします。
```
Set-Location "C:\PSF"
.\nuget\nuget.exe install Microsoft.PackageSupportFramework
```

Windows 10 SDK をダウンロードしてインストールするには:

Win 10 SDK をダウンロードします。
winsdksetup.exeを実行 します 。
[次へ] を選択します。
次の 3 つの機能のみを選択します。
- デスクトップアプリ用 Windows SDK 署名ツール
- UWP C++ アプリ用 Windows SDK
- UWP アプリのローカライズ用 Windows SDK
[ インストール] を選択し、[ OK] を選択します。

Windows アプリをステージングする

Windows アプリをステージングすると、アプリの内容が抽出され、ローカルディレクトリにパッケージ化解除されます。 Windows アプリがステージングの場所に展開されたら、PSF fixup ファイルを挿入して不要なエクスペリエンスを修正できます。

管理 PowerShell ウィンドウで、特定のアプリファイルと SDK バージョンを対象Windows 10次の変数を設定します。

$AppPath          = "C:\PSF\SourceApp\PSFSampleApp.msix"         ## Path to the MSIX App Installer
$StagingFolder    = "C:\PSF\Staging\PSFSampleApp"                ## Path to where the MSIX App will be staged
$OSArchitecture   = "x$((gwmi Win32_Processor).AddressWidth)"    ## Operating System Architecture
$Win10SDKVersion  = "10.0.19041.0"                               ## Latest version of the Win10 SDK

次の PowerShell コマンドレットを実行して、Windows アプリをステージングフォルダーに展開します。

## Sets the directory to the Windows 10 SDK
Set-Location "${env:ProgramFiles(x86)}\Windows Kits\10\Bin\$Win10SDKVersion\$OSArchitecture"

## Unpackages the Windows app to the staging folder
.\makeappx.exe unpack /p "$AppPath" /d "$StagingFolder"

必要な PSF ファイルを作成して挿入する

Windows アプリを修正するには、失敗した Windows アプリ起動ツールに関する情報を含む config.json ファイルを作成します。複数の Windows アプリ起動ツールで問題が発生している場合は、複数のエントリで config.json ファイルを構成できます。

config.json ファイルを作成したら、config.json とサポートされている PSF fixup ファイルを Windows アプリパッケージのルートに移動します。

Visual Studio Code または別のテキストエディターを開きます。
Windows アプリのステージングディレクトリ C:\PSF\Staging\PSFSampleApp に config.json という名前の新しいファイルを作成します。

新しく作成した config.json ファイルに次のコードをコピーします。

{
    "applications": [
        {
            "id": "",
            "executable": ""
        }
    ],
    "processes": [
        {
            "executable": "",
            "fixups": [
            {
                "dll": "",
                "config": {
                    "redirectedPaths": {
                        "packageRelative": [
                            {
                                "base": "",
                                "patterns": [
                                    ""
                                ]
                            }
                        ]
                    }
                }
            }
        ]
        }
    ]
}

Windows アプリのステージングフォルダーで AppxManifest.xml ファイルを開きます。次の例は、 AppxManifest.xml ファイルを示しています。

<Applications>
    <Application Id="PSFSAMPLE" Executable="VFS\ProgramFilesX64\PS Sample App\PSFSample.exe" EntryPoint="Windows.FullTrustApplication">
    <uap:VisualElements BackgroundColor="transparent" DisplayName="PSFSample" Square150x150Logo="Assets\StoreLogo.png" Square44x44Logo="Assets\StoreLogo.png" Description="PSFSample">
        <uap:DefaultTile Wide310x150Logo="Assets\StoreLogo.png" Square310x310Logo="Assets\StoreLogo.png" Square71x71Logo="Assets\StoreLogo.png" />
    </uap:VisualElements>
    </Application>
</Applications>

config.json ファイルで次の変更を行います。
- 値を、applications.idAppxManifest.xml ファイルのフィールドとApplications.Application.ID同じ値に設定します。
- applications.executableAppxManifest.xml ファイルのフィールドにあるアプリケーションへの相対パスをApplications.Application.Executableターゲットにする値を設定します。
- applications.workingdirectoryAppxManifest.xmlファイルのフィールド内の相対フォルダーパスをApplications.Application.Executableターゲットにする値を設定します。
- process.executableAppxManifest.xmlファイルのフィールドで、パスと拡張子を指定せずにファイル名をApplications.Application.Executableターゲットにするように値を設定します。
- 値を processes.fixups.dll 設定して、アーキテクチャ固有 FileRedirectionFixup.dllのをターゲットにします。修正が x64 アーキテクチャの場合は、値をに FileRedirectionFixup64.dll設定します。アーキテクチャが x86 の場合、または不明な場合は、値をに FileRedirectionFixup86.dll設定します。
- 値を、processes.fixups.config.redirectedPaths.packageRelative.baseAppxManifest.xml ファイルのフィールドのApplications.Application.Executableパッケージ相対フォルダーパスに設定します。
- アプリケーションが作成する processes.fixups.config.redirectedPaths.packageRelative.patterns ファイルの種類と一致するように値を設定します。を使用 .*\\.logすると、PSF はディレクトリと子ディレクトリ内 processes.fixups.config.redirectedPaths.packageRelative.base のすべてのログファイル書き込みをリダイレクトします。

更新した config.json ファイルを保存します。更新された config.json ファイルの例を次に示します。

{
    "applications": [
        {
        "id": "PSFSample",
        "executable": "VFS/ProgramFilesX64/PS Sample App/PSFSample.exe"
        }
    ],
    "processes": [
        {
            "executable": "PSFSample",
            "fixups": [
                {
                    "dll": "FileRedirectionFixup64.dll",
                    "config": {
                        "redirectedPaths": {
                            "packageRelative": [
                                {
                                    "base": "VFS/ProgramFilesX64/PS Sample App/",
                                    "patterns": [
                                        ".*\\.log"
                                    ]
                                }
                            ]
                        }
                    }
                }
            ]
        }
    ]
}

アプリケーション実行可能アーキテクチャのパッケージサポートフレームワークから、ステージングされた Windows アプリのルートに次のファイルをコピーします。 ファイルは.\Microsoft.PackageSupportFramework.\Version>\<bin にあります。

アプリケーション (x64)	アプリケーション (x86)
PSFLauncher64.exe	PSFLauncher32.exe
PSFRuntime64.dll	PSFRuntime32.dll
PSFRunDll64.exe	PSFRunDll32.exe
FileRedirectionFixup64.dll	FileRedirectionFixup64.dll

AppxManifest を更新する

config.json ファイルを作成して更新した後、config.json に含める Windows アプリ起動ツールごとに Windows アプリのAppxManifest.xml ファイルを更新します。 AppxManifest.xmlApplicationsは、アプリケーションアーキテクチャに関連付けられているPSFLauncher.exeをターゲットにする必要があります。

ステージングされた MSIX アプリフォルダー C:\PSF\Staging\PSFSampleApp でAppxManifest.xmlを開きます。

次 のコードを使用してAppxManifest.xml を更新します。

<Package ...>
...
<Applications>
    <Application Id="PSFSample"
                Executable="PSFLauncher32.exe"
                EntryPoint="Windows.FullTrustApplication">
    ...
    </Application>
</Applications>
</Package>

アプリケーションを再パッケージ化する

すべての修正を適用したら、Windows アプリを MSIX に再パッケージ化し、コード署名証明書で署名します。

管理 PowerShell ウィンドウを開きます。

次の変数を設定します。

$AppPath          = "C:\PSF\SourceApp\PSFSampleApp_Updated.msix" ## Path to the MSIX App Installer
$CodeSigningCert  = "C:\PSF\Cert\CodeSigningCertificate.pfx"     ## Path to your code signing certificate
$CodeSigningPass  = "<Password>"                                 ## Password used by the code signing certificate
$StagingFolder    = "C:\PSF\Staging\PSFSampleApp"                ## Path to where the MSIX App will be staged
$OSArchitecture   = "x$((gwmi Win32_Processor).AddressWidth)"    ## Operating System Architecture
$Win10SDKVersion  = "10.0.19041.0"                               ## Latest version of the Win10 SDK

次の PowerShell コマンドレットを実行して、ステージングフォルダーから Windows アプリを再パックします。

Set-Location "${env:ProgramFiles(x86)}\Windows Kits\10\Bin\$Win10SDKVersion\$OSArchitecture"
.\makeappx.exe pack /p "$AppPath" /d "$StagingFolder"

次の PowerShell コマンドレットを実行して、Windows アプリに署名します。

Set-Location "${env:ProgramFiles(x86)}\Windows Kits\10\Bin\$Win10SDKVersion\$OSArchitecture"
.\signtool.exe sign /v /fd sha256 /f $CodeSigningCert /p $CodeSigningPass $AppPath

パッケージサポートフレームワークファイルシステム書き込みアクセス許可エラーを修正する方法

調査

Windows アプリのエラーをキャプチャする

Windows アプリのエラーログを確認する

解決方法

必要なツールをダウンロードしてインストールする

Windows アプリをステージングする

必要な PSF ファイルを作成して挿入する

AppxManifest を更新する

アプリケーションを再パッケージ化する

その他のリソース

その他のリソース

パッケージ サポート フレームワーク ファイル システム書き込みアクセス許可エラーを修正する方法

調査

Windows アプリのエラーをキャプチャする

Windows アプリのエラー ログを確認する

解決方法

必要なツールをダウンロードしてインストールする

Windows アプリをステージングする

必要な PSF ファイルを作成して挿入する

AppxManifest を更新する

アプリケーションを再パッケージ化する

その他のリソース

その他のリソース

パッケージサポートフレームワークファイルシステム書き込みアクセス許可エラーを修正する方法

Windows アプリのエラーログを確認する