Gpresult


Applies To: Windows Server 2008,Windows Server 2008 R2,Windows Server 2003,Windows Vista,Windows Server 2003 R2,Windows 7

Displays the Resultant Set of Policy (RSoP) information for a remote user and computer. For examples of how this command can be used, see Examples.

Syntax


Copy Code

gpresult [/s <COMPUTER> [/u <USERNAME> [/p [<PASSWORD>]]]] [/user [<TARGETDOMAIN>\]<TARGETUSER>] [/scope {user | computer}] {/r | /v | /z | [/x | /h] <FILENAME> [/f] | /?}

Parameters

Note

Except when you use /?, you must include an output option, either /r, /v, /z, /x, or /h.

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 <USERNAME>

Uses the credentials of the specified user to run the command. 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 that is specified by the FILENAME parameter. Cannot be used with /u, /p, /r, /v, or /z.

/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

Examples

The following example retrieves RSoP data for the remote user targetusername of the computer srvmain, and displays RSoP data about the user only. The command is run with the credentials of the user maindom\hiropln, and p@ssW23 is entered as the password for that user.


Copy Code

gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /user targetusername /scope user /r

The following example saves all available information about Group Policy for the remote user targetusername of the computer srvmain to a file that is named policy.txt. No data is included about the computer. The command is run with the credentials of the user maindom\hiropln, and p@ssW23 is entered as the password for that user.


Copy Code

gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /user targetusername /z > policy.txt

The following example displays RSoP data for the computer srvmain and the logged-on user. Data is included about both the user and the computer. The command is run with the credentials of the user maindom\hiropln, and p@ssW23 is entered as the password for that user.


Copy Code

gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /r

Additional references