一般的な問題に対する修正

これらの修正は記載されたシナリオでのみ使用してください！

不要に適用すると逆効果になる可能性があるため、これらを盲目的に適用することは意図されていません。

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

次のものの展開を強く推奨します BranchCache のリセットまたはクリア 毎日のスケジュールでの修復スクリプト。これは次の場所で見つかります 修復スクリプト RealmJoin ポータルのセクション。

この方法を使用すると、上記の BranchCache 問題が積極的に検出され、可能であれば自動的に修復されます。

不足している / 間違ったパッケージ引数

1. 次のファイルを確認してください chocolatey.log の値のためのファイル packageParameters セクションで RJAppDeployToolkit: Resulting Variables

   • これらはインストールに使用され、RealmJoin バックエンドによって渡される実際の値です。

2. 期待する値でない場合は、グループ／ユーザー上書き値のために RealmJoin ポータルでのパッケージ割り当てを確認してください。

破損した .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 設定

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 トレイメニューに項目がない場合は、再度再起動してください。

一般的なセットアップの問題

これらは非常に個別の問題であるため、問題の範囲を絞るのに役立つ一般的なトラブルシューティング手順のコレクションにすぎません。

• ログファイルを次で確認してください C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\.

  • ログファイルを解析して問題を見つけるよう試みてください。

• ログファイルが存在しない、または役に立たない場合は、GUI モードでセットアップを手動で実行して、表示される可能性のあるエラーメッセージを確認してください。

  • 重要：RealmJoin のシステムパッケージは常に組み込みの NT AUTHORITY\SYSTEM アカウントを使ってインストールされるため、次のようなツールを使用して psexec そのアカウントからインストールを実行するのが最適です。

  • ほとんどの場合、標準のローカル管理者アカウントでインストールを実行しても同じエラーが発生するため、から実行する必要はない場合があります。 NT AUTHORITY\SYSTEM 必要ないかもしれません。

インストール可能なパッケージがない / RealmJoin トレイメニューに表示されない

• パッケージがユーザーに正しく割り当てられているか、ユーザーが割り当てられたグループのメンバーであるかを確認してください

• パッケージが非表示として割り当てられていないか確認してください（非表示割り当てパッケージを確認するにはデバッグモードを使用）

• ユーザーがクライアントのプライマリユーザーであるかを確認するか、あるいはパッケージがセカンダリユーザーに利用可能に設定されているかを確認してください

ConfigUpdater の認可エラー

RJ エージェントが構成にアクセスできません

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

1. RealmJoin トークンファイルを削除：

   • C:\Program Files\RealmJoin %LOCALAPPDATA%\\RealmJoin

   • RJ 4.19 以下 token2.dat

   • RJ 4.20 以降： msal_cache.dat

2. 再起動