Risposte agli errori nei connettori di Microsoft Graph

L'interfaccia utente visualizza un numero limitato di errori di connessione. Per un elenco completo, seguire questa procedura per generare un report degli errori dettagliato usando uno script di PowerShell.

1. Aprire Windows PowerShell con diritti di amministratore.
2. Installare lo script dalla raccolta di PowerShell usando il comando seguente

    Install-Script -Name DownloadErrorScript

Con questo script è possibile scaricare gli errori dell'elemento da una connessione ai connettori di Microsoft Graph. Genera un token MSAL usando le credenziali del tenant associate alla connessione. L'installazione dello script include automaticamente il modulo MSAL.PS. In caso contrario, installare il modulo manualmente con

    Install-Module -Name MSAL.PS

Per altre informazioni, vedere Scaricare lo script di errore.

3. Dopo l'installazione, eseguire lo script

    DownloadErrorScript.ps1

4. Specificare l'ID connessione della connessione per cui si vuole scaricare il report degli errori.
5. Specificare il nome del file di output senza estensione (senza estensione, il valore predefinito è .csv).
6. Definire le dimensioni del batch per il download degli errori. I batch più grandi sono adatti a migliaia di errori per ridurre al minimo il tempo di recupero dei dati, ma possono aumentare la probabilità di errori. La dimensione massima del batch è di 5000 errori. Dopo aver eseguito l'accesso usando l'account tenant, inizia il processo di download.
7. A seconda delle dimensioni del batch e del numero di errori, la durata del download varia. Il file generato viene salvato nel percorso di esecuzione dello script con il nome specificato.

Monitorare gli errori

Per monitorare gli errori, passare a Origini> datiActive Connector. Eventuali errori di ricerca per indicizzazione esistenti vengono visualizzati in Errori di ricerca per indicizzazione> correnti. Questa sezione fornisce

• Codici di errore: Elenchi i vari codici di errore rilevati.
• Conteggio: visualizza il numero di occorrenze per ogni codice di errore.
• Download del log degli errori: offre opzioni per scaricare il log degli errori.

Per visualizzare informazioni dettagliate su un errore specifico, selezionare il codice di errore corrispondente.

L'elenco seguente mostra i diversi errori che possono essere visualizzati in qualsiasi connessione.

Codice errore	Messaggio di errore	Soluzione
1000	L'origine dati non è disponibile. Controllare la connessione Internet o assicurarsi che l'origine dati sia ancora accessibile dal connettore.	Questo errore si verifica quando l'origine dati non è raggiungibile a causa di un problema di rete o quando l'origine dati stessa viene eliminata, spostata o rinominata. Verificare se i dettagli dell'origine dati forniti sono ancora validi.
1001	Non è possibile aggiornare i dati perché l'origine dati limita il connettore.	Per annullare la limitazione dell'origine dati, verificare se i limiti di scalabilità possono essere aumentati o attendere fino a un orario del giorno meno impegnativo per il traffico.
1002	Non è possibile eseguire l'autenticazione con l'origine dati. Verificare che le credenziali associate all'origine dati siano corrette.	Selezionare Modifica per aggiornare le credenziali di autenticazione.
1003	L'account associato al connettore non dispone dell'autorizzazione per accedere all'elemento.	Assicurarsi che l'account appropriato abbia accesso all'elemento da indicizzare.
1005	Le credenziali associate a questa origine dati sono scadute. Rinnovare le credenziali e aggiornare la connessione.	Selezionare Modifica per aggiornare le credenziali di autenticazione.
1008	L'utilizzo totale della quota del tenant ha raggiunto il limite.	Provare a eliminare una connessione per liberare parte della quota o modificare i filtri di inserimento per inserire meno dati. Se questi passaggi non risolvono il problema, contattare il supporto tecnico Microsoft.
1009	L'utilizzo totale della quota per la connessione ha raggiunto il limite.	Provare a modificare i filtri di inserimento per inserire meno dati. Se questo passaggio non risolve il problema, contattare il supporto tecnico Microsoft.
1010	L'utilizzo totale della quota per l'indicizzazione di gruppi non Azure AD ha raggiunto il limite di 100 K.	Provare a eliminare una connessione per liberare parte della quota o modificare i filtri di inserimento per inserire meno dati. Se questi passaggi non risolvono il problema, contattare il supporto tecnico Microsoft.
1011	L'agente connettore Microsoft Graph non è raggiungibile o offline.
1012	L'autenticazione alla connessione non è riuscita a causa di una modalità di autenticazione non supportata.	Modificare la connessione per aggiornare le impostazioni di autenticazione per la connessione.
1015	Connections creato in questo agente avrà esito negativo a causa di autorizzazioni insufficienti. Concedere l'autorizzazione ExternalItem.ReadWrite.OwnedBy all'app Microsoft Azure usata per la registrazione per consentire all'app di leggere e scrivere tutti gli elementi esterni senza un utente connesso e riprendere la ricerca per indicizzazione.	Assicurarsi che l'app Azure usata per la registrazione dell'agente disponga dell'autorizzazione ExternalItem.ReadWrite.OwnedBy.
1016	Connections creato in questo agente avrà esito negativo a causa di autorizzazioni insufficienti. Concedere l'autorizzazione Directory.Read.All all'app Microsoft Azure usata per la registrazione per leggere i dati nella directory dell'organizzazione e riprendere la ricerca per indicizzazione.	Assicurarsi che l'app Azure usata per la registrazione dell'agente disponga di un'autorizzazione Directory.Read.All.
1017	L'elemento non può essere indicizzato perché la rete non è disponibile.	Ripristinare la rete e attendere che la ricerca per indicizzazione successiva per l'elemento sia indicizzata.
1018	Assicurarsi che l'account utente immesso disponga dei diritti di accesso interattivo al computer in cui è installato l'agente connettore Microsoft Graph.	Assicurarsi che l'account utente disponga dei diritti di accesso interattivo al computer in cui è installato l'agente connettore Microsoft Graph. Per altre informazioni, vedere la documentazione .
1019	Connessione non riuscita perché le credenziali dell'app assegnate all'istanza GCA non sono valide o scadute. Aggiornare le credenziali.	Controllare le credenziali dell'app per l'istanza GCA associata alla connessione.
1020	L'agente connettore Microsoft Graph associato alla connessione non è in grado di connettersi al server del connettore GRPC.	L'istanza GCA non è riuscita a eseguire la ricerca per indicizzazione dell'origine dati perché si è verificato un problema di connessione al connettore personalizzato tramite GRPC.
1025	Microsoft Graph Connector Agent associato a questa connessione è deprecato a causa di problemi critici. Eseguire l'aggiornamento alla versione più recente. Altre informazioni: https://aka.ms/gca	Aggiornare la versione dell'agente connettore Microsoft Graph scaricando la versione più recente da https://aka.ms/GCAdownload|
1026	Connessione THh non riuscita a causa di un problema critico con l'agente connettore Microsoft Graph associato. Eseguire l'aggiornamento alla versione più recente o contattare il supporto tecnico per risolvere il problema. Altre informazioni: https://aka.ms/gca	Aggiornare la versione dell'agente connettore Microsoft Graph scaricando la versione più recente da https://aka.ms/GCAdownload|
2001	L'indicizzazione viene limitata a causa di un numero elevato di aggiornamenti nella coda. A seconda della coda, il completamento degli aggiornamenti può richiedere del tempo.	Attendere fino a quando la coda non viene cancellata.
2002	Indicizzazione non riuscita a causa della formattazione degli elementi non supportata.	Per altre informazioni, vedere la documentazione specifica del connettore.
2003	Indicizzazione non riuscita a causa di contenuto dell'elemento non supportato.	Per altre informazioni, vedere la documentazione specifica del connettore.
2004	L'indicizzazione non è riuscita a causa di dimensioni di file o elementi non supportate.	Per altre informazioni, vedere la documentazione specifica del connettore.
2005	L'indicizzazione non è riuscita perché l'URI è troppo lungo.	Per altre informazioni, vedere la documentazione specifica del connettore.
2006	Mapping utente non riuscito a causa di una formula di mapping non valida o di nessun utente Microsoft Entra con questa proprietà.	Provare a eliminare e ricreare la connessione con una formula di mapping diversa.
2007	Questo elemento non verrà visualizzato in Microsoft Search perché alcuni utenti o gruppi senza l'autorizzazione per visualizzare questo elemento non possono essere indicizzati.
2008	Connections non possono avere gruppi non Azure AD con più di 50.000 membri.	Provare a rimuovere gli utenti da un gruppo o a rimuovere gli elementi acLed con tale gruppo dall'inserimento e ricreare la connessione.
2009	L'indicizzazione del gruppo non Azure AD è temporaneamente sospesa a causa di un numero elevato di richieste. L'indicizzazione riprende al termine dell'elaborazione di queste richieste da parte del sistema. Riprova in un secondo momento.
2010	Questa connessione non è più valida a causa di un aggiornamento eseguito da Microsoft.	Eliminare la connessione e crearne una nuova.
5000	Si è verificato un problema. Se il problema persiste, contattare il supporto tecnico.