The gpfixup command in Windows

The gpfixup command fixes domain dependencies in Group Policy Objects and Group Policy links after the operation of renaming a domain. For an example of how to use this command, please see the example below.

Syntax gpfixup command

 Gpfixup [/v] [/olddns: /newdns:] [/oldnb: /newnb:] [/dc:] [/sionly] [/user: [/pwd:{|*}]] [/?] 

Parameters

Parameter / v Description Displays detailed status messages.
If this parameter is not used, only the error message or the status message summarizing SUCCESS or FAILURE appears. / olddns: Specifies the old DNS name of the domain name to be renamed when the domain change operation changes the DNS name of that domain. You can only use this parameter if you also use the / newdns parameter to specify a new DNS domain name. / newdns: Specifies the new DNS name of the domain name to be renamed when the domain name change operation changes the DNS name of that domain. You can only use this parameter if you also use the / olddns parameter to specify the old DNS domain name. / oldnb: Specify the old NetBIOS name of the domain to be renamed when the domain renaming operation changes the NetBIOS name of that domain. You can only use this parameter if you use the / newnb parameter to specify a new NetBIOS domain name. / newnb: Specify the new NetBIOS name of the domain name that was renamed when the domain renaming operation changed the NetBIOS name of that domain. You can only use this parameter if you use the / oldnb parameter to specify the old NetBIOS domain name. / dc:

Connect to a named domain controller (DNS name or NetBIOS name). must store a writable copy of the domain directory partition, indicated by one of the following:
- DNS name using parameter / newdns.
- NetBIOS name using the parameter / newnb.

If this parameter is not used, connect to any domain controller in the renamed domain, specified by or .

/ sionly Only fix Group Policy errors related to installing managed software (Software Installation extension for Group Policy). Ignore actions to edit Group Policy links and SYSVOL links in GPOs. / user:

Run this command in the user's security context , which is in domainuser format.

If this parameter is not used, run this command as a logged-in user.

/ pwd: {*} /? Show help at the command prompt.

Note

1. The gpfixup command is available in Windows Server 2008 R2 and Windows Server 2008, except for Server Core installations.
2. Although the Group Policy Management Console (GPMC) is distributed with Windows Server 2008 R2 and Windows Server 2008, you still have to install the Group Policy Management as a feature through Server Manager.

For example

This example assumes that you have changed the domain name, in which you changed the DNS name from MyOldDnsName to MyNewDnsName and the NetBIOS name from MyOldNetBIOSName to MyNewNetBIOSName. In this example, you use the gpfixup command to connect to the domain controller named MyDcDnsName and fix the GPO and Group Policy links by updating the old domain name embedded in the GPO and the link. The status and output errors are saved to a file named gpfixup.log.

 gpfixup /olddns: MyOldDnsName /newdns:MyNewDnsName /oldnb:MyOldNetBIOSName /newnb:MyNewNetBIOSName /dc:MyDcDnsName 2>&1 >gpfixup.log 

This example is the same as the previous example, except that it assumes the NetBIOS name of the domain name has not been changed during the domain name change process.

 gpfixup /olddns: MyOldDnsName /newdns:MyNewDnsName /dc:MyDcDnsName 2>&1 >gpfixup.log 

See more:

1. The bootcfg addsw command in Windows
2. The bootcfg command copies in Windows
3. The autoconv command in Windows