> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/ja/troubleshooting.md). # トラブルシューティング 何かが動作していない場合は、ここから始めてください。次の手順に従って問題を特定し、該当する解決ページに移動します。 ## 始める前に もし **複数のユーザーが同時に同じ問題を報告している**、または 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 のトレイ アイコンを右クリック → **アカウント**。アカウントが表示されていない場合は、サインインしてください。 * 「管理者の承認が必要です」→ [Tenant 全体への管理者同意を付与する](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. **共有を手動で追加しようとして「サイトを開けませんでした: Key not found」と表示されますか？** * → [共有を追加:「Key not found」](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 の権限が不完全な可能性があります。 * → [Tenant 全体への管理者同意を付与する](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. **「管理者の承認が必要です」** * → [Tenant 全体への管理者同意を付与する](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 のパスを Trusted Sites ゾーンに入れる必要があります。→ [KONNEKT のパスを信頼済みサイトとして追加する](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites) 3. **Office ファイルを開いたりプレビューしたりすると KONNEKT がクラッシュする** * Attack Surface Reduction (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 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.konnekt.io/ja/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.