CmdID

CmdID / Commands

dfsrmig

The migration tool for the DFS Replication service, dfsrmig.exe, is installed with the DFS Replication service. Windows commands reference

On Windows File dfsrmig.exe

Opens CmdID with your command. It is read in your browser and sent nowhere.

Windows

from the Windows commands reference, CC BY 4.0

The migration tool for the DFS Replication service, dfsrmig.exe, is installed with the DFS Replication service. This tool migrates SYSvol replication from File Replication Service (FRS) to Distributed File System (DFS) Replication. It also provides information about the progress of the migration and modifies Active Directory Domain Services (AD DS) objects to support the migration.

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

To set the global migration state to Prepared (1) and to initiate migration or to rollback from the Prepared state, type

dfsrmig /setglobalstate 1Identify
/setglobalstateSets the domain's global migration state to one that corresponds to the value specified by *state*. Windows commands reference

To set the global migration state to Start (0) and to initiate rollback to the Start state, type

dfsrmig /setglobalstate 0Identify
/setglobalstateSets the domain's global migration state to one that corresponds to the value specified by *state*. Windows commands reference

To display the global migration state, type

dfsrmig /getglobalstateIdentify
/getglobalstateRetrieves the current global migration state for the domain from the local copy of the AD DS database, when run on the PDC emulator. Windows commands reference

To display information about whether the local migration states on all the domain controllers match the global migration state and if there are any local migration states where the local state doesn't match the global state, type

dfsrmig /GetMigrationStateIdentify
/GetMigrationStateRetrieves the current local migration state for all domain controllers in the domain and determines whether those local states match the current global migration state. Windows commands reference

To create the global objects and settings that DFS Replication uses in AD DS on domain controllers where those settings were not created automatically during migration or where those settings are missing, type

dfsrmig /createglobalobjectsIdentify
/createglobalobjectsCreates the global objects and settings in AD DS used by DFS Replication uses. Windows commands reference

To delete the global AD DS settings for FRS replication for a read-only domain controller named contoso-dc2 if those settings were not deleted automatically by the migration process, type

dfsrmig /deleterontfrsmember contoso-dc2Identify
/deleterontfrsmemberDeletes the global AD DS settings for FRS replication that correspond to the specified read-only domain controller, or deletes the global AD DS settings for FRS replication for all read-only domain controllers if no val… Windows commands reference

To delete the global AD DS settings for FRS replication for all read-only domain controllers if those settings were not deleted automatically by the migration process, type

dfsrmig /deleterontfrsmemberIdentify
/deleterontfrsmemberDeletes the global AD DS settings for FRS replication that correspond to the specified read-only domain controller, or deletes the global AD DS settings for FRS replication for all read-only domain controllers if no val… Windows commands reference

To delete the global AD DS settings for DFS Replication for a read-only domain controller named contoso-dc2 if those settings were not deleted automatically by the migration process, type

dfsrmig /deleterodfsrmember contoso-dc2Identify
/deleterodfsrmemberDeletes the global AD DS settings for DFS Replication that correspond to the specified read-only domain controller, or deletes the global AD DS settings for DFS Replication for all read-only domain controllers if no val… Windows commands reference

To delete the global AD DS settings for DFS Replication for all read-only domain controllers if those settings were not deleted automatically by the migration process, type

dfsrmig /deleterodfsrmemberIdentify
/deleterodfsrmemberDeletes the global AD DS settings for DFS Replication that correspond to the specified read-only domain controller, or deletes the global AD DS settings for DFS Replication for all read-only domain controllers if no val… Windows commands reference

To display help at the command prompt

dfsrmigIdentify
/setglobalstate <state>Sets the domain's global migration state to one that corresponds to the value specified by state. You can only set the global migration state to a stable state. The state values include: - 0 - Start state - 1 - Prepared state - 2 - Redirected state - 3 - Eliminated state
/getglobalstateRetrieves the current global migration state for the domain from the local copy of the AD DS database, when run on the PDC emulator. Use this option to confirm that you set the correct global migration state. Important: You should only run this command on the PDC emulator.
/getmigrationstateRetrieves the current local migration state for all domain controllers in the domain and determines whether those local states match the current global migration state. Use this option to determine if all domain controllers have reached the global migration state.
/createglobalobjectsCreates the global objects and settings in AD DS used by DFS Replication uses. The only situations where you should use this option to manually create objects and settings, are: - A new read-only domain controller is promoted during migration. If a new read-only domain controller is promoted in the domain after moving into the Prepared state, but before migration to the Eliminated state, then the objects that correspond to the new domain controller aren't created, causing replication and the migration to fail. - Global settings for the DFS Replication service are missing or were deleted. If these settings are missing for a domain controller, migration from the Start state to the Prepared state will stall at the Preparing transition state. Note: Because the global AD DS settings for the DFS Replication service for a read-only domain controller are created on the PDC emulator, these settings need to replicate to the read-only domain controller from the PDC emulator before the DFS Replication service on the read-only domain controller can use these settings. Because of Active Directory replication latencies, this replication can take some time to occur.
/deleterontfrsmember [<read_only_domain_controller_name>]Deletes the global AD DS settings for FRS replication that correspond to the specified read-only domain controller, or deletes the global AD DS settings for FRS replication for all read-only domain controllers if no value is specified for <read_only_domain_controller_name>. You shouldn't need to use this option during a normal migration process, because the DFS Replication service automatically deletes these AD DS settings during the migration from the Redirected state to the Eliminated state. Use this option to manually delete the AD DS settings only when the automatic deletion fails on a read-only domain controller and stalls the read-only domain controller for a long time during the migration from the Redirected state to the Eliminated state.
/deleterodfsrmember [<read_only_domain_controller_name>]Deletes the global AD DS settings for DFS Replication that correspond to the specified read-only domain controller, or deletes the global AD DS settings for DFS Replication for all read-only domain controllers if no value is specified for <read_only_domain_controller_name>. Use this option to manually delete the AD DS settings only when the automatic deletion fails on a read-only domain controller and stalls the read-only domain controller for a long time when rolling back the migration from the Prepared state to the start state.
/?Displays help at the command prompt.