PowerShell Logo Small

Invoke-GPUpdate



This is the built-in help made by Microsoft for the command 'Invoke-GPUpdate', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Schedule a remote Group Policy refresh (gpupdate) on the specified computer.

SYNTAX


Invoke-GPUpdate [[-Computer] <String>] [[-RandomDelayInMinutes] <Int32>] [-AsJob] [-Boot] [-Force] [-LogOff] [-Target <String>] [<CommonParameters>]
Invoke-GPUpdate [[-Computer] <String>] [[-RandomDelayInMinutes] <Int32>] [-AsJob] [-Boot] [-LogOff] [-Sync] [-Target <String>] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Invoke-GPUpdate cmdlet refreshes Group Policy settings, including security settings that are set on remote computers by scheduling the running of the Gpupdate command on
a remote computer. You can combine this cmdlet in a scripted fashion to schedule the Gpupdate command on a group of computers.


The refresh can be scheduled to immediately start a refresh of policy settings or wait for a specified period of time, up to a maximum of 31 days. To avoid putting a load on
the network, the refresh times will be offset by a random delay.



<

RELATED LINKS


Online Version: http://go.microsoft.com/fwlink/?linkid=287723

REMARKS

<

Examples


-------------------------- EXAMPLE 1 --------------------------

PS C:\>Invoke-GPUpdate



Description

-----------

This command schedules a Group Policy refresh on the computer on which you are running the Invoke-GPUpdate cmdlet.




-------------------------- EXAMPLE 2 --------------------------

PS C:\>Invoke-GPUpdate -computer COMPUTER-02 -Target user -Sync



Description

-----------

This command schedules a Group Policy refresh on a remote computer (CONTOSO\COMPUTER-02) which will only schedule to update the user policy settings in synchronous mode.