Servizio di sincronizzazione Azure AD Connect: estensioni della directoryAzure AD Connect sync: Directory extensions

Le estensioni della directory consentono di estendere lo schema in Azure AD con attributi personalizzati da Active Directory in locale.Directory extensions allows you to extend the schema in Azure AD with your own attributes from on-premises Active Directory. Questa funzionalità consente di compilare app line-of-business che utilizzano attributi che continuano a essere gestiti in locale.This feature allows you to build LOB apps consuming attributes you continue to manage on-premises. Questi attributi possono essere utilizzati tramite le estensioni della directory Azure AD Graph o Microsoft Graph.These attributes can be consumed through Azure AD Graph directory extensions or Microsoft Graph. È possibile visualizzare gli attributi disponibili usando rispettivamente lo strumento di esplorazione di Azure AD Graph e lo strumento di esplorazione di Microsoft Graph.You can see the attributes available using Azure AD Graph explorer and Microsoft Graph explorer respectively.

Attualmente nessun carico di lavoro di Office 365 utilizza questi attributi.At present no Office 365 workload consumes these attributes.

È possibile configurare gli attributi aggiuntivi da sincronizzare nel percorso delle impostazioni personalizzate nell'installazione guidata.You configure which additional attributes you want to synchronize in the custom settings path in the installation wizard. Procedura guidata per l'estensione dello schemaSchema Extension Wizard
L'installazione mostra gli attributi seguenti, che sono candidati validi:The installation shows the following attributes, which are valid candidates:

  • Tipi di oggetto utente e gruppoUser and Group object types
  • Attributi a valore singolo: String, Boolean, Integer, BinarySingle-valued attributes: String, Boolean, Integer, Binary
  • Attributi multivalore: String, BinaryMulti-valued attributes: String, Binary

Nota

Anche se Azure AD Connect supporta la sincronizzazione di attributi AD multivalore con Azure AD come estensioni di directory multivalore, Azure AD non offre attualmente funzionalità che supportino l'uso delle estensioni di directory multivalore.While Azure AD Connect supports synchronizing multi-valued AD attributes to Azure AD as multi-valued directory extensions, there are currently no features in Azure AD that support the use of multi-valued directory extensions.

L'elenco di attributi viene letto dalla cache dello schema creata durante l'installazione di Azure AD Connect.The list of attributes is read from the schema cache created during installation of Azure AD Connect. Se è stato esteso lo schema di Active Directory con altri attributi, prima che questi nuovi attributi siano visibili è quindi necessario aggiornare lo schema della directory .If you have extended the Active Directory schema with additional attributes, then the schema must be refreshed before these new attributes are visible.

Un oggetto in Azure AD può avere al massimo 100 attributi delle estensioni della directory.An object in Azure AD can have up to 100 directory extensions attributes. La lunghezza massima consentita è di 250 caratteri.The max length is 250 characters. Se il valore di un attributo è più lungo, viene quindi troncato dal motore di sincronizzazione.If an attribute value is longer, then it is truncated by the sync engine.

Durante l'installazione di Azure AD Connect viene registrata un'applicazione in cui sono disponibili questi attributi.During installation of Azure AD Connect, an application is registered where these attributes are available. È possibile visualizzare questa applicazione nel portale di Azure.You can see this application in the Azure portal.
App estensione dello schema

Questi attributi ora sono disponibili tramite Graph: These attributes are now available through Graph:
Grafico

Gli attributi sono preceduti da extension_{AppClientId}_.The attributes are prefixed with extension_{AppClientId}_. AppClientId ha lo stesso valore per tutti gli attributi nel tenant di Azure AD.The AppClientId has the same value for all attributes in your Azure AD tenant.

Passaggi successiviNext steps

Ulteriori informazioni sulla configurazione della sincronizzazione di Azure AD Connect.Learn more about the Azure AD Connect sync configuration.

Ulteriori informazioni su Integrazione delle identità locali con Azure Active Directory.Learn more about Integrating your on-premises identities with Azure Active Directory.