Microsoft DOS gpupdate command

Quick links

About help
Availability
Syntax
Examples

About gpupdate

Refreshes the local computers policy and any Active Directory-based Group policies.

Availability

The gpupdate.exe command is an external command and is available in the below Microsoft operating systems.

Windows XP
Windows Vista
Windows 7

Syntax

GPUpdate [/Target:{Computer | User}] [/Force] [/Wait:<value>] [/Logoff] [/Boot] [/Sync]

/Target:{Computer | User} Specifies that only User or only Computer policy settings are refreshed. By default, both User and Computer policy settings are refreshed.
/Force Reapplies all policy settings. By default, only policy settings that have changed are applied.
/Wait:{value} Sets the number of seconds to wait for policy processing to finish. The default is 600 seconds. The value '0' means not to wait. The value '-1' means to wait indefinitely. When the time limit is exceeded, the command prompt returns, but policy processing continues.
/Logoff Causes a logoff after the Group Policy settings have been refreshed. This is required for those Group Policy client-side extensions that do not process policy on a background refresh cycle but do process policy when a user logs on. Examples include user-targeted Software Installation and Folder Redirection. This option has no effect if there are no extensions called that require a logoff.
/Boot Causes a reboot after the Group Policy settings are refreshed. This is required for those Group Policy client-side extensions that do not process policy on a background refresh cycle but do process policy at computer startup. Examples include computer-targeted Software Installation. This option has no effect if there are no extensions called that require a reboot.
/Sync Causes the next foreground policy application to be done synchronously. Foreground policy applications occur at computer boot and user logon. You can specify this for the user, computer or both using the /Target parameter. The /Force and /Wait parameters will be ignored if specified.

Examples

gpupdate

Running the command alone will refresh the computers policies as shown below in the example output.

Refreshing Policy...

User Policy Refresh has completed.
Computer Policy Refresh has completed.

Additional information

  • See our Active Directory definition for further information and related links on this term.