> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/toraburushtinguto-faq/troubleshooting/package-installation-issues/fixes-for-common-issues.md). # 一般的な問題の修正 {% hint style="danger" %} **これらの修正は、説明されたシナリオでのみ使用してください！** **これらは、むやみに適用することを意図したものではありません。不要に適用すると、かえって害になる可能性があります。** {% endhint %} ## BranchCache の問題 * エラーメッセージ `ディスクの空き容量が不足しています` (Windows OS の言語によってはローカライズされた形でも発生する場合があります) ダウンロード段階での chocolatey の終了コード `404`: 1. 管理者権限の PowerShell を開く 2. 実行 `Clear-BCCache -Force` * エラーメッセージ `指定されたオブジェクトは初期化されていません` (Windows OS の言語によってはローカライズされた形でも発生する場合があります) ダウンロード段階での chocolatey の終了コード `404`: 1. 管理者権限の PowerShell を開く 2. 実行 `Reset-BC -Force` * エラーメッセージ `エラー - ハッシュが一致しません。実際の値は '123abcd' でした`: 1. 管理者権限の PowerShell を開く 2. 実行 `Reset-BC -Force` {% hint style="warning" %} 以下を展開することを強く推奨します **BranchCache の Reset または Clear** 日次スケジュール付きの修復スクリプト。次の場所にあります: [修復スクリプト](/ja/zi-dong-hua/remediation-scripts.md) RealmJoin Portal のセクション。 この方法を使用すると、前述の BranchCache の問題が事前に検出され、（可能であれば）自動的に修復されます。 {% endhint %} ## Package 引数がない / 誤っている 1. 次を確認してください `chocolatey.log` ファイル内の次の値を確認してください： `packageParameters` セクションで `RJAppDeployToolkit: 生成された変数` * これらは、インストールに使用され、RealmJoin バックエンドから渡された実際の値です。 2. それらが期待している値でない場合は、RealmJoin ポータルでパッケージの割り当てを確認し、グループ / ユーザーの上書き値を確認してください。 ## 破損した .nupkg ファイル 次のエラーが表示された場合は、 `chocolatey.log` .nupkg ファイルが破損しています: `[ERROR] - パス 'generic-package-id\\generic-package-id.nupkg' からパッケージを読み取れません。` しばしば、.nupkg ファイルのサイズが 0 バイトであることも確認できます。 この問題を修正する手順: 1. 次へ移動し、 `C:\\ProgramData\\chocolatey\\lib` 2. フォルダーを削除 `generic-package-id` ## 壊れた chocolatey 設定 1. フォルダーの内容を削除 `C:\\ProgramData\\chocolatey\\config` 2. システム変数を削除 `ChocolateyInstall` : * GUI を使用: 実行 `sysdm.cpl` → タブ `詳細設定` -> `環境変数...` * (管理者) cmd を使用して、次を実行: `REG delete "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /V ChocolateyInstall` 3. 再起動 4. RealmJoin tray が chocolatey を再インストールします。システムが落ち着くまで 5～10 分待ってください。 5. RealmJoin tray メニューで項目が見つからない場合は、もう一度再起動してください。 ## 一般的なセットアップの問題 **これらは非常に個別性が高いため、これは問題を絞り込むのに役立つ一般的なトラブルシューティング手順の集まりにすぎません。** * 次の場所にログファイルがあるか確認してください: `C:\WINDOWS\Logs\RealmJoin\Packages\\`. * ログファイルを分析して、問題を見つけてみてください。 * ログファイルがない、または役に立たない場合は、GUI モードでセットアップを手動実行し、表示される可能性のあるエラーメッセージを確認してください。 * 重要: RealmJoin システムパッケージは、常に組み込みの `NT AUTHORITY\\SYSTEM` アカウントを使用してインストールされるため、次のようなツールを使用するのが最善です: `psexec` そのアカウントからインストールを実行するために。 * ほとんどの場合、標準のローカル管理者アカウントでインストールを実行しても同じエラーが発生するため、 `NT AUTHORITY\\SYSTEM` 必要ないかもしれません。 ### パッケージがインストール可能になっていない / RealmJoin tray メニューに表示されない * パッケージがユーザーに正しく割り当てられているか、またはユーザーが割り当てられたグループのメンバーか確認してください * パッケージが非表示として割り当てられていないか確認してください（非表示の割り当て済みパッケージを表示するには Debug Mode を使用してください） * ユーザーがそのクライアントのプライマリユーザーか確認してください。あるいは、パッケージがセカンダリユーザーでも利用できるように構成されているか確認してください ## ConfigUpdater へのアクセスが許可されていません

RJ エージェントは設定にアクセスできません

この問題の主な原因は、access token が期待どおり自動更新されなかったことです。通常、access token はリソースへの途切れないアクセスを確保するために自動的に更新されます。しかし、この場合は期待された処理が失敗し、その結果 token が古くなってアクセス問題が発生しました。これは、今後同様の問題を防ぐために、自動 token 更新メカニズムが正しく機能していることを確認することの重要性を示しています。この根本原因に対処することで、安定したアクセスを維持し、中断を避けるのに役立ちます 1. RealmJoin の token ファイルを削除してください: * パス： `%LOCALAPPDATA%\\RealmJoin` * RJ 4.19 以前 `token2.dat` * RJ 4.20 以降: `msal_cache.dat` 2. 再起動 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/ja/toraburushtinguto-faq/troubleshooting/package-installation-issues/fixes-for-common-issues.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.