> 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 %}

## パッケージ引数が不足している / 誤っている <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] - パス '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` psexec から実行する必要はないかもしれません。

### パッケージをインストールできない / 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, and the optional `goal` query parameter:

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

`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.
