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

# よくある問題の修正

BranchCache エラーなどの一般的な RealmJoin パッケージ インストール問題に対する、特定シナリオ向けの対処策です。

{% 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 のリセットまたはクリア** 毎日スケジュールの修復スクリプトです。場所は次のとおりです: [修復スクリプト](/ja/zi-dong-hua/remediation-scripts.md) RealmJoin Portal のセクションにあります。

この方法を使用すると、上記の BranchCache の問題は事前に検出され、可能な場合は自動的に修復されます。
{% endhint %}

## Chocolatey の一時フォルダーの肥大化

Chocolatey パッケージのインストーラーファイルは次の場所にダウンロードされます。 `C:\Windows\Temp\chocolatey\<package-id>\<version>\` そして、インストール後も削除されません。これは従来の Chocolatey エンジンと次のものの両方に当てはまります。 [Native Choco Runtime](/ja/realmjoin-agent/realmjoin-client/native-choco-runtime.md)。時間の経過とともに、このフォルダーはかなりのディスク容量を占有することがあります。

このフォルダーを自動的にクリーンアップしたい場合は、次をデプロイしてください。 **Chocolatey の一時フォルダーのクリーンアップ** 次の場所にある修復スクリプトを [修復スクリプト](/ja/zi-dong-hua/remediation-scripts.md) RealmJoin Portal のセクションからデプロイしてください。7 日より古いパッケージ バージョン フォルダーを削除します。

## 不足している / 誤ったパッケージ引数 <a href="#user-content-missing-wrong-package-arguments" id="user-content-missing-wrong-package-arguments"></a>

1. 次を確認してください: `chocolatey.log` ファイル内の次の値を確認してください: `packageParameters` 次のセクションで `RJAppDeployToolkit: Resulting Variables`
   * これらは、インストールに使用され、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` 必要ないかもしれません。

### パッケージをインストールできない / 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>

* パッケージがユーザーに正しく割り当てられているか、またはユーザーが割り当てられたグループのメンバーであるか確認してください
* パッケージが非表示で割り当てられていないか確認してください（非表示の割り当て済みパッケージを表示するにはデバッグモードを使用します）
* ユーザーがクライアントの主ユーザーであるか確認してください。あるいは、パッケージがセカンダリユーザーでも利用できるように構成されているか確認してください


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.