# トラブルシューティング

何かうまく動作しないときは、ここから始めてください。次の手順に従って問題を特定し、関連する解決ページへ進んでください。

## 始める前に

次の場合 **複数のユーザーが同時に同じ問題を報告している**、または KONNEKT のデバッグログに Graph API エラー（HTTP 429、500、503、504、または `UnknownError`）が表示される場合、原因は KONNEKT ではなく Microsoft 365 のバックエンドにある可能性があります。まずこれを確認してください: [Graph Explorer でファイルの問題を再現する](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).

## 問題は何ですか?

### KONNEKT のドライブまたは共有が表示されない

1. **KONNEKT はインストールされていますか?**
   * 確認してください: `Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -like "*Konnekt*" }`
   * 未インストール → [KONNEKT をインストールする](https://docs.konnekt.io/installation/setup)
   * ARM64 デバイスでは、ARM64 版をインストールしたことを確認してください。ARM64 に x64 をインストールすると、インストールは成功したように見えますが、ドライバーの読み込みに失敗します。→ [デバイスを開けませんでした](https://docs.konnekt.io/troubleshooting/failed-to-open-device)
2. **インストール後にデバイスは再起動されましたか?**
   * KONNEKT はカーネルモードドライバーを読み込むために再起動が必要です。再起動してもう一度確認してください。
3. **KONNEKT サービスは実行されていますか?**
   * 確認してください: `Get-Service -Name "Konnekt*"`
   * 実行されていない → サービスを再起動するか、再インストールしてください。
4. **ユーザーはサインインしていますか?**
   * KONNEKT のトレイアイコンを右クリック → **アカウント**。アカウントが一覧にない場合は、サインインしてください。
   * 「管理者の承認が必要です」→ [テナント全体の管理者同意を付与する](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
5. **ドライブまたは共有は表示されるが、クリックしても何も起きませんか?**
   * → [共有をクリックしても何も起きない](https://docs.konnekt.io/troubleshooting/clicking-a-share-does-nothing)

### サイトまたはライブラリが見つからない

1. **自動マッピングを使用していますか?**
   * 次を確認してください `O365SharepointUsage = 1` がレジストリにあること。
   * SharePoint の Web インターフェースで、ユーザーがそのサイトにアクセスできることを確認してください。
   * KQL のサイトクエリを確認してください。制限の厳しいクエリではサイトが除外される可能性があります。参照: [自動マッピング](https://docs.konnekt.io/configuration/mappings/auto-mapping).
   * サイトがグループでフィルターされている場合は、ユーザーの Microsoft Entra ID グループ メンバーシップを確認してください。
   * サイトの所有者だがメンバーではない? KONNEKT の検出では、ユーザーが **メンバー** であるサイトのみが見つかります。→ [一部のサイトまたはライブラリが KONNEKT に表示されない](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)
2. **管理対象マッピングを使用していますか?**
   * 次の設定が適用されていることを確認してください `SharepointSites` ポリシー: `gpresult /r` またはレジストリを確認してください。
   * ポリシー内の SharePoint URL が正しく、アクセス可能であることを確認してください。
3. **共有を手動で追加しようとして「サイトを開けませんでした: キーが見つかりません」と表示されますか?**
   * → [共有を追加: 「キーが見つかりません」](https://docs.konnekt.io/troubleshooting/add-share-key-not-found)
4. **SharePoint にはサイトがあるのに KONNEKT にはない?**
   * ユーザーがそのサイトへのアクセス権を持っていない可能性があります。SharePoint の Web インターフェースでアクセスをテストしてください。
   * サイトの種類が KQL クエリと一致していない可能性があります（たとえば、個人用 OneDrive サイトは既定のクエリでは検出されません）。

→ [サイトが見つからない、またはフォルダーが空](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) | [一部のサイトまたはライブラリが表示されない](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)

### フォルダーが空

1. **すべてのライブラリが空ですか?**
   * 管理者同意が付与されていないか、API のアクセス許可が不完全である可能性があります。
   * → [テナント全体の管理者同意を付与する](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
   * → [空のライブラリ](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries)
2. **特定のライブラリが空ですか?**
   * ユーザーがそのライブラリの内容へのアクセス権を持っていない可能性があります。SharePoint のアクセス許可を確認してください。
   * 実際にライブラリが空である可能性があります。
3. **管理対象マッピングで空のフォルダーが表示される?**
   * ポリシー内のサイト URL が正しくない可能性があります。ブラウザーで URL を開いて確認してください。

→ [空のライブラリ](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries) | [サイトが見つからない、またはフォルダーが空](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty)

### 認証エラー

1. **「アクセス トークンを取得できませんでした」**
   * → [アクセス トークンの問題](https://docs.konnekt.io/troubleshooting/access-token-issues)
2. **MFA プロンプトのループ（MFA プロンプトが繰り返される）**
   * Conditional Access ポリシーの競合または WAM ブローカーの問題。
   * → [Conditional Access](https://docs.konnekt.io/installation/security/conditional-access)
3. **間違ったアカウントでサインインしている**
   * トレイアイコンを右クリック → **アカウント** → 間違ったアカウントを削除 → 正しいアカウントを追加します。
4. **「管理者の承認が必要です」**
   * → [テナント全体の管理者同意を付与する](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)

→ [アクセス トークンの問題](https://docs.konnekt.io/troubleshooting/access-token-issues)

### ファイル操作エラー

1. **アップロードに失敗しました**
   * トレイアイコン → でエラーの詳細を確認してください **エラー**.
   * ネットワーク接続を確認してください。
   * SharePoint のスロットリングが発生していないか確認してください（デバッグログに HTTP 429 がないか確認）。スロットリングまたはバックエンド エラーが見られる場合は、 [Graph Explorer で再現し](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) Microsoft 側の問題であることを確認してください。
   * → [エラーへの対処方法](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)
2. **ファイルがロックされている / 予期せず読み取り専用になっている**
   * 他のユーザーが、そのファイルを共同編集なしで開いている可能性があります。
   * ファイルが読み取り専用のサイズしきい値を超えている可能性があります。→ [ファイルサイズの制限を開く](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations)
3. **アクセスが拒否されました**
   * ユーザーには SharePoint への書き込み権限がありません。Web インターフェースで確認してください。
4. **「パスが長すぎます」またはファイル名エラー**
   * パスとファイル名の長さが制限内か確認してください。→ [最大のパス長とファイル名長はいくつですか?](https://docs.konnekt.io/troubleshooting/what-is-the-maximum-path-and-file-name-length)

→ [エラーへの対処方法](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)

### Office ファイルを開けない

1. **Office が開くときに警告を表示する（「コンピューターに害を及ぼす可能性があります」）**
   * ネットワーク上の場所からのファイルには、Mark of the Web (MOTW) が適用されています。→ [MS Office ドキュメントを開くと警告メッセージが表示される](https://docs.konnekt.io/troubleshooting/opening-ms-office-documents-displays-a-warning-message)
   * KONNEKT のパスを信頼済みサイトに追加すると解決することがよくあります。→ [KONNEKT のパスを信頼済みサイトとして追加する](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
2. **Office ファイルをダブルクリックしても何も起きない、または Excel のマクロファイルが開かない**
   * KONNEKT のパスを信頼済みサイト ゾーンに入れる必要があります。→ [KONNEKT のパスを信頼済みサイトとして追加する](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
3. **Office ファイルを開く、またはプレビューすると KONNEKT がクラッシュする**
   * 攻撃面の縮小 (ASR) ルールが KONNEKT をブロックしている可能性があります。次を除外してください `Konnekt.exe` および `KonnektStarter.exe` を「Office Child Process」ASR ルールから。→ [危険な操作がブロックされました](https://docs.konnekt.io/troubleshooting/risky-action-blocked)
4. **Office に古いバージョンのファイルが表示される**
   * → [Office に古いバージョンが表示される](https://docs.konnekt.io/troubleshooting/office-shows-outdated-versions)

### パフォーマンスの問題

1. **フォルダーの参照が遅い**
   * フォルダー内の項目数を確認してください（1,000 項目を超えると参照が遅くなります）。
   * キャッシュ設定を確認してください。TTL が非常に低いと API 呼び出しが増えます。
   * デバッグログで Graph API の 429 または 5xx エラーと遅さが相関している場合は、 [Graph Explorer で再現し](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) スロットリングまたはバックエンドの問題を確認してください。
2. **ファイルを開くのが遅い**
   * ファイルサイズとネットワーク帯域幅を確認してください。
   * スロットリング（ログ内の HTTP 429）がないか確認してください。存在する場合は、 [Graph Explorer で再現し](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).
3. **断続的な遅さ（特に朝）**
   * KONNEKT ドライブをウイルス対策ソフトがスキャンしている可能性が高いです。
   * → [ウイルス対策ソフトのスキャンが原因の遅いパフォーマンスまたはエラー](https://docs.konnekt.io/troubleshooting/slow-performance-or-errors-caused-by-antivirus-scanning)

### その他の問題

| 問題                          | 解決方法                                                                                                                                                                                                 |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PDF プレビューが壊れる（Windows 11）   | → [Windows 11 の更新後に PDF プレビューが壊れる](https://docs.konnekt.io/troubleshooting/pdf-preview-broken-after-windows-11-update)                                                                               |
| ファイルに灰色の X が表示される           | 想定される動作です。KONNEKT は帯域幅を節約するためにファイルを `FILE_ATTRIBUTE_OFFLINE` としてマークします。エラーではありません。参照: [なぜ灰色の X または茶色のスーツケース](https://docs.konnekt.io/troubleshooting/why-is-there-a-grey-x-on-my-files-and-folders). |
| ファイルに茶色のスーツケースのオーバーレイが表示される | ファイルはオフライン使用としてマークされています。想定される動作です。                                                                                                                                                                  |
| KONNEKT のトレイアイコンがない         | デバイスを再起動してください。それでも表示されない場合は、KONNEKT を再インストールしてください。                                                                                                                                                 |
| 問題を解決できない                   | → [デバッグログを準備する](https://docs.konnekt.io/troubleshooting/debug-log-preparation) および [サポートに連絡する](https://docs.konnekt.io/support)                                                                      |

## 関連ページ

* [Graph Explorer でファイルの問題を再現する](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) - KONNEKT の問題と Microsoft 365 のバックエンドの問題を切り分ける
* [変更履歴](https://docs.konnekt.io/changelog) - 最近の修正と解決済みの問題
* [デバッグログの準備](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - サポート用ログの収集方法
* [サポート](https://docs.konnekt.io/support) - KONNEKT サポートへの問い合わせ方法


---

# 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.konnekt.io/ja/troubleshooting.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.