dfsrmig

S’applique à : Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

L’outil de migration pour le service de réplication DFS, dfsrmig.exe, est installé avec le service de réplication DFS. Cet outil migre la réplication SYSvol de FRS (Service de réplication de fichiers) vers DFS (Système de fichiers distribués). Il fournit également des informations sur la progression de la migration, et modifie les objets AD DS (Active Directory Domain Services) de façon à prendre en charge la migration.

Syntaxe

dfsrmig [/setglobalstate <state> | /getglobalstate | /getmigrationstate | /createglobalobjects |
/deleterontfrsmember [<read_only_domain_controller_name>] | /deleterodfsrmember [<read_only_domain_controller_name>] | /?]

Paramètres

Paramètre Description
/setglobalstate <state> Définit l’état de migration global du domaine sur un état qui correspond à la valeur spécifiée par state. Vous pouvez uniquement définir l’état de migration global sur un état stable. Les valeurs de state sont les suivantes :
  • 0 : état Démarrage
  • 1 : état Préparé
  • 2 : état Redirigé
  • 3 : état Éliminé
/getglobalstate Récupère l’état de migration global actuel pour le domaine à partir de la copie locale de la base de données AD DS, lors de l’exécution sur l’émulateur PDC. Utilisez cette option pour confirmer que vous avez défini l’état de migration global correct.

Important : Vous devez exécuter cette commande uniquement sur l’émulateur PDC.

/getmigrationstate Récupère l’état de migration local actuel pour tous les contrôleurs de domaine du domaine, et détermine si ces états locaux correspondent à l’état de migration global actuel. Utilisez cette option pour déterminer si tous les contrôleurs de domaine ont atteint l’état de migration global.
/createglobalobjects Crée les paramètres et objets globaux dans AD DS utilisés par la réplication DFS. Les seules situations où vous devez utiliser cette option pour créer manuellement des objets et des paramètres sont les suivantes :
  • Un nouveau contrôleur de domaine en lecture seule est promu pendant la migration. Si un nouveau contrôleur de domaine en lecture seule est promu dans le domaine après être passé à l’état Préparé, mais avant la migration vers l’état Éliminé, les objets qui correspondent au nouveau contrôleur de domaine ne sont pas créés, ce qui entraîne l’échec de la réplication et de la migration.
  • Les paramètres globaux du service de réplication DFS sont manquants ou ont été supprimés. Si ces paramètres sont manquants pour un contrôleur de domaine, la migration de l’état Démarrage à l’état Préparé se bloque à l’état transitoire Préparation. Remarque : Étant donné que les paramètres AD DS globaux pour le service de réplication DFS pour un contrôleur de domaine en lecture seule sont créés sur l’émulateur PDC, ces paramètres doivent être répliqués sur le contrôleur de domaine en lecture seule à partir de l’émulateur PDC pour que le service de réplication DFS sur le contrôleur de domaine en lecture seule puisse les utiliser. En raison des latences de réplication Active Directory, cette réplication peut prendre un certain temps.
/deleterontfrsmember [<read_only_domain_controller_name>] Supprime les paramètres AD DS globaux pour la réplication FRS qui correspondent au contrôleur de domaine en lecture seule spécifié, ou supprime les paramètres AD DS globaux pour la réplication FRS pour tous les contrôleurs de domaine en lecture seule si aucune valeur n’est spécifiée pour <read_only_domain_controller_name>.

Vous ne devriez pas avoir besoin d’utiliser cette option pendant un processus de migration normal, car le service de réplication DFS supprime automatiquement ces paramètres AD DS pendant la migration de l’état Redirigé vers l’état Éliminé. Utilisez cette option pour supprimer manuellement les paramètres AD DS uniquement lorsque la suppression automatique échoue sur un contrôleur de domaine en lecture seule et bloque le contrôleur de domaine en lecture seule pendant une longue période lors de la migration de l’état Redirigé vers l’état Éliminé.

/deleterodfsrmember [<read_only_domain_controller_name>] Supprime les paramètres AD DS globaux pour la réplication DFS qui correspondent au contrôleur de domaine en lecture seule spécifié, ou supprime les paramètres AD DS globaux pour la réplication DFS pour tous les contrôleurs de domaine en lecture seule si aucune valeur n’est spécifiée pour <read_only_domain_controller_name>.

Utilisez cette option pour supprimer manuellement les paramètres AD DS uniquement lorsque la suppression automatique échoue sur un contrôleur de domaine en lecture seule et bloque le contrôleur de domaine en lecture seule pendant une longue période lors de la restauration de la migration de l’état Préparé vers l’état Démarrage.

/? Affiche l'aide à l'invite de commandes.

Notes

  • Utilisez la commande /setglobalstate <state> pour définir l’état de migration global dans AD DS sur l’émulateur PDC afin de lancer et de contrôler le processus de migration. Si l’émulateur PDC n’est pas disponible, cette commande échoue.

  • La migration vers l’état Éliminé est irréversible et la restauration n’est pas possible. Par conséquent, utilisez la valeur 3 pour state uniquement lorsque vous vous engagez sans réserve à utiliser la réplication DFS pour la réplication SYSvol.

  • Les états de migration globaux doivent être un état de migration stable.

  • La réplication Active Directory réplique l’état global vers d’autres contrôleurs de domaine dans le domaine, mais en raison des latences de réplication, vous pouvez observez des incohérences si vous exécutez dfsrmig /getglobalstate sur un contrôleur de domaine autre que l’émulateur PDC.

  • La sortie de dfsrmig /getmigrationstate indique si la migration vers l’état global actuel est terminée, listant l’état de migration local pour tous les contrôleurs de domaine qui n’ont pas encore atteint l’état de migration global actuel. L’état de migration local pour les contrôleurs de domaine peut également inclure des états transitoires pour les contrôleurs de domaine qui n’ont pas atteint l’état de migration global actuel.

  • Les contrôleurs de domaine en lecture seule ne peuvent pas supprimer les paramètres d’AD DS ; l’émulateur PDC effectue cette opération et les modifications finissent par être répliquées sur les contrôleurs de domaine en lecture seule après les latences applicables pour la réplication Active Directory.

  • La commande dfsrmig est prise en charge uniquement sur les contrôleurs de domaine qui s’exécutent au niveau fonctionnel du domaine Windows Server, car la migration SYSvol de FRS vers DFS n’est possible que sur les contrôleurs de domaine qui fonctionnent à ce niveau.

  • Vous pouvez exécuter la commande dfsrmig sur n’importe quel contrôleur de domaine, mais les opérations qui créent ou manipulent des objets AD DS ne sont autorisées que sur les contrôleurs de domaine en lecture-écriture (pas sur les contrôleurs de domaine en lecture seule).

Exemples

Pour définir l’état de migration global sur Préparé (1) et lancer la migration ou effectuer une restauration à partir de l’état Préparé, tapez :

dfsrmig /setglobalstate 1

Pour définir l’état de migration global sur Démarrage (0) et lancer la restauration vers l’état Démarrage, tapez :

dfsrmig /setglobalstate 0

Pour afficher l’état de migration global, tapez :

dfsrmig /getglobalstate

Sortie de la commande dfsrmig /getglobalstate :

Current DFSR global state: Prepared
Succeeded.

Pour afficher des informations indiquant si les états de migration locaux sur tous les contrôleurs de domaine correspondent à l’état de migration global et s’il existe des états de migration locaux qui ne correspondent pas à l’état global, tapez :

dfsrmig /GetMigrationState

Sortie de la commande dfsrmig /getmigrationstate lorsque les états de migration locaux sur tous les contrôleurs de domaine correspondent à l’état de migration global :

All Domain Controllers have migrated successfully to Global state (Prepared).
Migration has reached a consistent state on all Domain Controllers.
Succeeded.

Sortie de la commande dfsrmig /getmigrationstate lorsque les états de migration locaux sur certains contrôleurs de domaine ne correspondent pas à l’état de migration global :

The following Domain Controllers are not in sync with Global state (Prepared):
Domain Controller (Local Migration State) DC type
=========
CONTOSO-DC2 (start) ReadOnly DC
CONTOSO-DC3 (Preparing) Writable DC
Migration has not yet reached a consistent state on all domain controllers
State information might be stale due to AD latency.

Pour créer les paramètres et objets globaux que la réplication DFS utilise dans AD DS sur les contrôleurs de domaine où ces paramètres n’ont pas été créés automatiquement pendant la migration ou lorsque ces paramètres sont manquants, tapez :

dfsrmig /createglobalobjects

Pour supprimer les paramètres AD DS globaux pour la réplication FRS pour un contrôleur de domaine en lecture seule nommé contoso-dc2 si ces paramètres n’ont pas été supprimés automatiquement par le processus de migration, tapez :

dfsrmig /deleterontfrsmember contoso-dc2

Pour supprimer les paramètres AD DS globaux pour la réplication FRS pour tous les contrôleurs de domaine en lecture seule si ces paramètres n’ont pas été supprimés automatiquement par le processus de migration, tapez :

dfsrmig /deleterontfrsmember

Pour supprimer les paramètres AD DS globaux pour la réplication DFS pour un contrôleur de domaine en lecture seule nommé contoso-dc2 si ces paramètres n’ont pas été supprimés automatiquement par le processus de migration, tapez :

dfsrmig /deleterodfsrmember contoso-dc2

Pour supprimer les paramètres AD DS globaux pour la réplication DFS pour tous les contrôleurs de domaine en lecture seule si ces paramètres n’ont pas été supprimés automatiquement par le processus de migration, tapez :

dfsrmig /deleterodfsrmember

Pour afficher l’aide à l’invite de commandes :

dfsrmig
dfsrmig /?