> 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 をリセットまたはクリアする** 日次スケジュールの修復スクリプト。これは [修復スクリプト](https://docs.realmjoin.com/ja/zi-dong-hua/remediation-scripts.md) RealmJoin Portal のセクションにあります。

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

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

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

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

## 不足している / 誤った 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] - 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` -> タブ `Advanced` -> `環境変数...`
   * (管理者) cmd を使用して、次を実行します: `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall`
3. 再起動する
4. RealmJoin tray が chocolatey を再インストールします。システムが落ち着くまで 5〜10 分待ってください。
5. RealmJoin tray メニューで項目が欠けている場合は、もう一度再起動してください。

## 一般的なセットアップの問題 <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 tray メニューに表示されない <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 を使用して、非表示の割り当て済みパッケージを確認できます）
* ユーザーがクライアントのプライマリユーザーであるか確認してください。あるいは、パッケージがセカンダリユーザーでも利用可能になるよう構成されているか確認してください


---

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