# よくある問題の修正

{% 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" %}
以下の項目を展開することを強く推奨します **Reset or Clear BranchCache** 修復スクリプトを毎日実行するスケジュールで。これは RealmJoin Portal の [修復スクリプト](/ja/zi-dong-hua/remediation-scripts.md) セクションにあります。

この方法を使用すると、上記の 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 backend によって渡された実際の値です。
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 tray が chocolatey を再インストールします。システムが落ち着くまで 5～10 分待ってください。
5. RealmJoin tray メニューで項目が見つからない場合は、もう一度再起動してください。

## 一般的な Setup の問題 <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 を使用します）
* ユーザーがクライアントの primary user であるか確認してください。代わりに、パッケージが secondary users に利用可能になるよう構成されているか確認してください

## ConfigUpdater の権限なし <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

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

この問題の主な原因は、access token が期待どおりに自動更新されなかったことです。通常、access token はリソースへの中断のないアクセスを確保するために自動的に更新されます。しかし、この場合は期待されたプロセスが失敗し、token が古くなってアクセスの問題が発生しました。これは、今後同様の問題を防ぐために、自動 token refresh メカニズムが正しく機能していることを確認する重要性を示しています。この根本原因に対処することで、一貫したアクセスを維持し、次の中断を回避するのに役立ちます

1. RealmJoin トークンファイルを削除します:
   * パス： `%LOCALAPPDATA%\RealmJoin`
   * RJ 4.19 以前 `token2.dat`
   * RJ 4.20 以降: `msal_cache.dat`
2. 再起動


---

# Agent Instructions: 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.
