Étendre le schéma

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ce document explique comment étendre le schéma dans une instance du service géré pour Microsoft Active Directory.

Avant de commencer

Avant de commencer, procédez comme suit :

  1. Créez un domaine Microsoft AD géré.
  2. Créez une VM Windows et associez-la au domaine.
  3. Assurez-vous de lire l'article À propos des extensions de schéma et de lire ces considérations.
  4. Préparez le fichier LDIF avec les modifications de schéma. Pour en savoir plus, consultez Préparer votre fichier LDIF.
  5. Assurez-vous de disposer de l'un des rôles utilisateur Identity and Access Management (IAM) suivants:

    • Administrateur de domaine Google Cloud Managed Identities (roles/managedidentities.domainAdmin)
    • Administrateur Google Cloud Managed Identities (roles/managedidentities.admin)

    Pour en savoir plus, consultez Rôles Cloud Managed Identities.

Étendre le schéma

Lorsque vous lancez une extension de schéma, le service géré Microsoft AD crée automatiquement une sauvegarde d'extension de schéma avant d'appliquer les modifications du schéma. Vous pouvez utiliser cette sauvegarde pour restaurer le domaine si vous rencontrez des problèmes après l'extension du schéma. Pour identifier la sauvegarde de l'extension de schéma, vous pouvez répertorier les sauvegardes créées pour votre domaine.

Pour étendre le schéma, exécutez la commande gcloud CLI suivante:

gcloud active-directory domains extend-schema DOMAIN_NAME  --ldif-file=LDIF_FILE_PATH \
    --description=SCHEMA_EXTENSION_DESCRIPTION --project=DOMAIN_RESOURCE_PROJECT_ID --async

Remplacez les éléments suivants :

  • DOMAIN_NAME: nom de votre domaine Microsoft AD géré. Par exemple, my-domain.example.com.
  • LDIF_FILE_PATH: chemin d'accès au fichier LDIF avec le schéma modifié. La taille maximale des fichiers est limitée à 1 Mo.
  • SCHEMA_EXTENSION_DESCRIPTION : la description du schéma est modifiée.
  • DOMAIN_RESOURCE_PROJECT_ID: ID du projet de ressource de domaine. Par exemple, my-project.

Le service géré pour Microsoft AD lance l'extension du schéma et répond avec un ID d'opération qui vous permet de suivre la fin de l'extension du schéma.

Pour vérifier l'état de votre extension de schéma, exécutez la commande gcloud CLI suivante:

gcloud active-directory operations describe OPERATION_ID

Remplacez OPERATION_ID par l'ID d'opération de votre extension de schéma. Par exemple, operation-1234567890-98765a1b2c3d4e5-e6f7g8-9h0i1j2.

Vérifier l'extension du schéma

Après avoir étendu le schéma de votre instance Microsoft AD gérée, il est important de vérifier les modifications de schéma avant d'intégrer vos applications à Active Directory. Vous pouvez vérifier les modifications du schéma à l'aide de différents outils et approches. Dans les sections suivantes, nous expliquons comment vérifier les modifications du schéma à l'aide de l'une des approches suivantes:

  1. Snap-in du schéma Active Directory
  2. Windows PowerShell

Snap-in du schéma Active Directory

Pour vérifier les modifications du schéma à l'aide du composant logiciel enfichable Schéma d'Active Directory, procédez comme suit:

  1. Connectez-vous à votre VM jointe à un domaine en tant qu'administrateur délégué.
  2. Installez le Snap-in du schéma Active Directory.
  3. Ouvrez la console de gestion Microsoft (MMC).
  4. Développez l'arborescence Schéma Active Directory pour votre annuaire.
  5. Vérifiez si vous pouvez voir les modifications apportées aux classes et aux attributs du schéma.

Windows PowerShell

Pour vérifier les modifications du schéma à l'aide de Windows PowerShell, utilisez le cmdlet Get-ADObject. Exécutez la commande suivante dans Windows PowerShell:

get-adobject -Identity 'cn=ATTRIBUTE,cn=Schema,cn=Configuration,dc=ROOT_DOMAIN,dc=TOP_LEVEL_DOMAIN' -Properties *

Remplacez les éléments suivants :

  • ATTRIBUTE : nom d'un attribut de votre schéma. Par exemple, example-attribute.
  • ROOT_DOMAIN: domaine racine de votre nom de domaine. Par exemple, si votre nom de domaine est example.com, saisissez example.
  • TOP_LEVEL_DOMAIN: domaine de premier niveau de votre nom de domaine. Par exemple, si votre nom de domaine est example.com, saisissez com.

Dans la réponse, vérifiez si vous pouvez voir les modifications apportées aux classes et aux attributs du schéma.

Étapes suivantes