Displays the Resultant Set of Policy (RSoP) information for a remote user and computer.
For examples of how to use this command, see Examples.
Syntax
gpresult [/s <Computer> [/u [<Domain>\]<UserName> [/p [<Password>]]]] [/user [<TargetDomain>\]<TargetUser>] [/scope {user | computer}] [/r | /v | /z] [[/x | /h] <FileName> [/f]]
Parameters
| Parameter | Description |
|---|---|
|
/s <Computer> |
Specifies the name or IP address of a remote computer. Do not use backslashes. The default is the local computer. |
|
/u [<Domain>\]<UserName> |
Runs the command with the credentials of the specified user. The default user is the user who is logged on 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. /p cannot be used with /x or /h. |
|
/user [<TargetDomain>\]<TargetUser> |
Specifies the remote user whose RSoP data is to be displayed. |
|
/scope {user | computer} |
Displays RSoP data for either the user or the computer. If /scope is omitted, gpresult displays RSoP data for both the user and the computer. |
|
[/x | /h] <FileName> |
Saves the report in either XML (/x) or HTML (/h) format at the location and with the file name specified by the FileName parameter. Cannot be used with /u, /p, /r, /v, or /z. |
|
/f |
Forces gpresult to overwrite the file name specified in the /x or /h option. |
|
/r |
Displays RSoP summary data. |
|
/v |
Displays verbose policy information, including additional detailed settings that have been applied with a precedence of 1. |
|
/z |
Displays all available information about Group Policy, including detailed settings that have been 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 on the basis of their membership in sites, domains, or
organizational units.
- Because you can apply overlapping levels of policies to any
computer or user, the Group Policy feature generates a resulting
set of policies at logon. Gpresult displays the resulting
set of policies that were enforced on the computer for the
specified user at logon.
- Because /v and /z produce a lot of information,
it is useful to redirect output to a text file (for example,
gpresult /z >policy.txt).
Examples
The following examples show how you can use the gpresult command:
gpresult /user targetusername /scope computer /r gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /user targetusername /scope user gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /user targetusername /z >policy.txt gpresult /s srvmain /u maindom\hiropln /p p@ssW23