Refresh Group Policy settings with GPUpdate.exe
Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2
To refresh Group Policy settings with GPUpdate
The gpupdate command refreshes local and Active Directory–based Group Policy settings, including security settings on the computer from where it is run. You can use gpupdate locally on Windows XP and higher computers to refresh policy immediately. On computers running Windows 2000, this functionality is provided by the using the secedit command with the refreshpolicy option.
Syntax
Gpupdate [/target:{computer|user}] [/force] [/wait:value] [/logoff] [/boot]
Parameters
- ****/target:{computer|user}
Processes only the computer settings or the current user settings. By default, both the computer settings and the user settings are processed.
- /force
Ignores all processing optimizations and reapplies all settings. The Group Policy engine on the client tracks versions of the GPOs that are applied to the user and computer. By default, if none of the GPO versions change and the list of GPOs remains the same, the Group Policy engine will not reprocess policy. This option overrides this optimization and forces the Group Policy engine to reprocess all policy information.
- ****/wait:value
Number of seconds that policy processing waits to finish. The default is 600 seconds. 0 means "no wait"; -1 means "wait indefinitely."
- /logoff
Logs off after the refresh has completed. This is required for those Group Policy client-side extensions that do not process on a background refresh cycle but that do process when the user logs on, such as user Software Installation and Folder Redirection. This option has no effect if there are no extensions called that require the user to log off.
- /boot
Restarts the computer after the refresh has completed. This is required for those Group Policy client-side extensions that do not process on a background refresh cycle but that do process when the computer starts up, such as computer Software Installation. This option has no effect if there are no extensions called that require the computer to be restarted.
- /?
Displays help at the command prompt.
Remarks
- If you make a syntax error, a syntax summary appears that looks similar to this Help topic.
Examples
The following examples show how you can use the gpupdate command:
gpupdate
gpupdate /target:computer
**gpupdate /force /wait:**100
gpupdate /boot
Formatting legend
| Format | Meaning |
|---|---|
Italic |
Information that the user must supply |
Bold |
Elements that the user must type exactly as shown |
Ellipsis (...) |
Parameter that can be repeated several times in a command line |
Between brackets ([]) |
Optional items |
Between braces ({}); choices separated by pipe (|). Example: {even|odd} |
Set of choices from which the user must choose only one |
|
Code or program output |
Information about functional differences
- Your server might function differently based on the version and edition of the operating system that is installed, your account permissions, and your menu settings. For more information, see Viewing Help on the Web.