Displays the Resultant Set of Policy (RSoP) information for a remote user and computer. To use RSoP reporting for remotely targeted computers through the firewall, you must have firewall rules that enable inbound network traffic on the ports.
Syntax
gpresult [/s <system> [/u <username> [/p [<password>]]]] [/user [<targetdomain>\]<targetuser>] [/scope {user | computer}] {/r | /v | /z | [/x | /h] <filename> [/f] | /?}
Note: Except when using /?, you must include an output option, /r, /v, /z, /x, or /h.
Parameters
| Parameter | Description |
|---|---|
/s <system> |
Specifies the name or IP address of a remote computer. Don't use backslashes. The default is the local computer. |
/u <username> |
Uses the credentials of the specified user to run the command. The default user is the user who is signed in to the computer that issues the command. |
/p [<password>] |
Specifies the password of the user account that is provided in the /u parameter. If /p is omitted, gpresult prompts for the password. The /p parameter can't be used with /x or /h. |
/user [<targetdomain>\]<targetuser>] |
Specifies the remote user whose RSoP data is to be displayed. |
| /scope `{user | computer}` |
| `[/x | /h] <filename>` |
| /f | Forces gpresult to overwrite the file name that is specified in the /x or /h option. |
| /r | Displays RSoP summary data. |
| /v | Displays verbose policy information. This includes detailed settings that were applied with a precedence of 1. |
| /z | Displays all available information about Group Policy. This includes detailed settings that were applied with a precedence of 1 and higher. |
| /? | Displays help at the command prompt. |
Remarks
-
Group Policy is the primary administrative tool for defining and controlling how programs, network resources, and the operating system operate for users and computers in an organization. In an active directory environment, Group Policy is applied to users or computers based on their membership in sites, domains, or organizational units.
-
Because you can apply overlapping policy settings to any computer or user, the Group Policy feature generates a resulting set of policy settings when the user signs in. The gpresult command displays the resulting set of policy settings that were enforced on the computer for the specified user when the user signed in.
-
Because /v and /z produce much information, it's useful to redirect output to a text file (for example,
gpresult/z >policy.txt). -
On ARM64 versions of Windows, only the
gpresultin SysWow64 works with the/hparameter.
Examples
To retrieve RSoP data for only the remote user maindom\targetuser, on the computer srvmain, enter:
gpresult /s srvmain /user maindom\targetuser /scope user /r
To save all available information about Group Policy to a file named policy.txt for only the remote user maindom\targetuser, on the computer srvmain, enter:
gpresult /s srvmain /user maindom\targetuser /z > policy.txt
To display RSoP data for the signed-in user, maindom\hiropln with the password p@ssW23, for the computer srvmain, enter:
gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /r
Related links
Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors (upstream author metadata: robinharwood). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
