> 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/sono/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 をリセットまたはクリアする** 日次スケジュールの修復スクリプト。これは見つけることができます。 [Remediation Scripts](/ja/zi-dong-hua/remediation-scripts.md) RealmJoin Portal のセクション。

この方法を使用すると、前述の BranchCache の問題は事前に検知され、可能であれば自動的に修復されます。
{% endhint %}

## Package 引数の不足 / 誤り <a href="#user-content-missing-wrong-package-arguments" id="user-content-missing-wrong-package-arguments"></a>

1. 次を確認してください `chocolatey.log` ファイル内の〜の値について `packageParameters` 〜のセクション内で `RJAppDeployToolkit: 結果の変数`
   * これらは、インストールに使用され、RealmJoin バックエンドから渡された実際の値です。
2. 期待どおりの値でない場合は、グループ/ユーザーの上書き値について RealmJoin Portal のパッケージ割り当てを確認してください。

## 破損した .nupkg ファイル

次のエラーが表示される場合は、 `chocolatey.log` .nupkg ファイルが破損しています:

`[ERROR] - Unable to read package from path 'generic-package-id\generic-package-id.nupkg'.`

.nupkg ファイルのサイズが 0 バイトであることもよくあります。

この問題を修正する手順:

1. 次へ移動 `C:\ProgramData\chocolatey\lib`
2. フォルダーを削除 `generic-package-id`

## 破損した chocolatey 設定 <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

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 トレイが chocolatey を再インストールします。システムが落ち着くまで 5〜10 分待ってください。
5. RealmJoin トレイメニューに項目が表示されない場合は、もう一度再起動してください。

## 一般的なセットアップの問題 <a href="#user-content-general-setup-issues" id="user-content-general-setup-issues"></a>

**これらは非常に個別性が高いため、これは問題の絞り込みに役立つ一般的なトラブルシューティング手順の集まりにすぎません。**

* 〜内のログファイルを確認してください `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`.
  * ログファイルを分析して、問題を特定してみてください。
* ログファイルがない、または役に立たない場合は、GUI モードでセットアップを手動実行して、表示される可能性のあるエラーメッセージを確認してください。
  * 重要: RealmJoin のシステムパッケージは常に組み込みの `NT AUTHORITY\SYSTEM` アカウントを使用してインストールされるため、次のようなツールを使用するのが最善です: `psexec` そのアカウントからインストールを実行するために。
  * 通常は、標準のローカル管理者アカウントでインストールを実行しても同じエラーが出るため、 `NT AUTHORITY\SYSTEM` からの実行は必要ないかもしれません。

### インストール可能なパッケージではない / RealmJoin トレイメニューに表示されない <a href="#user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu" id="user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu"></a>

* パッケージがユーザーに正しく割り当てられているか、またはユーザーが割り当てられたグループのメンバーかを確認してください
* パッケージが非表示で割り当てられていないか確認してください（非表示の割り当て済みパッケージを表示するには Debug Mode を使用）
* ユーザーがクライアントのプライマリユーザーか確認してください。あるいは、パッケージがセカンダリユーザーでも利用可能に設定されているか確認してください

## ConfigUpdater の認可エラー <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

<figure><img src="/files/80cbc21373153ff1628e05f495875e4e77d3ec93" alt=""><figcaption><p>RJ エージェントは設定にアクセスできません</p></figcaption></figure>

この問題の主因は、アクセストークンが期待どおり自動更新されなかったことです。通常、リソースへの継続的なアクセスを確保するためにアクセストークンは自動的に更新されます。しかし、このケースでは期待された処理が失敗し、トークンが古くなったことでアクセスの問題が発生しました。これは、将来同様の問題を防ぐために、自動トークン更新の仕組みが正しく動作していることを確認する重要性を示しています。この根本原因に対処することで、一貫したアクセスを維持し、中断を回避できます。

1. RealmJoin のトークンファイルを削除してください:
   * パス: `%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:

```
GET https://docs.realmjoin.com/ja/sono/troubleshooting/package-installation-issues/fixes-for-common-issues.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.