banner

[PCHealth]

Answer File = Unattend.txt

The [PCHealth] section contains entries for configuring error reporting, Remote Assistance, and Help and Support Center.

Entry Description
ER_Display_UI Specifies whether Setup notifies the end user that an error has occurred and shows details about the error.
ER_Enable_Applications Specifies how Microsoft® Windows® reports errors that occur in applications.
ER_Enable_Kernel_Errors Specifies whether Windows reports errors in the Windows kernel.
ER_Enable_Reporting Specifies whether Windows automatically reports errors.
ER_Enable_Windows_Components Specifies whether to report errors in Windows applications.
ER_Exclude_EXE(n) Specifies an application for which Windows does not report any errors, if they occur.
ER_Force_Queue_Mode Specifies whether to send all reports in queue mode.
ER_Include_EXE(n) Specifies whether the error report includes the file name of the application causing the error.
ER_Include_MSApps Specifies whether to track and report errors in Microsoft applications.
ER_Include_Shutdown_Errs Specifies whether to report shutdown errors.
RA_AllowFullControl Specifies whether a person (other than the end user of the computer) can take full control of the computer from a separate location.
RA_AllowToGetHelp Specifies whether to enable Remote Assistance.
RA_AllowUnsolicited Specifies whether to enable unsolicited Remote Assistance.
RA_MaxTicketExpiry Specifies the time, in seconds, after which a Remote Assistance invitation expires.

Sample

This sample demonstrates one use of the [PCHealth] section of Unattend.txt.

[PCHealth]
ER_Display_UI = 1
ER_Enable_Applications = All
ER_Enable_Kernel_Error = 1
ER_Enable_Reporting = 1
ER_Enable_Windows_Components = 1
ER_Exclude_EXE1 = notepad.exe
ER_Force_Queue_Mode = 1
ER_Include_EXE1 = iexplore.exe
ER_Include_MSApps = 1
ER_Include_Shutdown_Errs = 1
RA_AllowFullControl = 0
RA_AllowToGetHelp = 1
RA_AllowUnsolicited = 0
RA_MaxTicketExpiry = 600

ER_Display_UI

Specifies whether Setup notifies the end user that an error has occurred and shows details about the error.

Syntax ER_Display_UI = 0 | 1
Values 0

Does not display the error notification user interface.

1

Displays the error notification user interface.

Example
ER_Display_UI = 1
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\PCHealth\
ErrorReporting\ShowUI
Comments If you enable ER_Enable_Reporting, the end user can choose to report the error. If you disable ER_Enable_Reporting and enable ER_Display_UI, the end user cannot report errors. If you disable ER_Display_UI and enable ER_Enable_Reporting, Setup automatically reports the errors, but does not notify the end user.

Note

  • For servers that do not have interactive users, consider disabling ER_Display_UI.

icon Return to top

ER_Enable_Applications

Specifies how Windows reports errors that occur in applications.

Syntax ER_Enable_Applications = All | Listed | None
Values All

Reports errors for all applications except for those listed in ER_Exclude_EXE(n).

Listed

Reports errors only for those applications listed in ER_Include_EXE(n) and Microsoft applications when you enable ER_Include_MSapps.

None

Reports no application errors.

Example
ER_Enable_Applications = All
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\
    PCHealth\ErrorReporting\AllOrNone
Comments Controls whether to report errors in applications when you enable ER_Enable_Reporting.

icon Return to top

ER_Enable_Kernel_Errors

Specifies whether Windows reports errors in the Windows kernel.

Syntax ER_Enable_Kernel_Errors = 0 | 1
Values 0

Does not report errors in the Windows kernel.

1

Reports errors in the Windows kernel when you enable ER_Enable_Reporting.

Example
ER_Enable_Kernel_Errors = 1
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\PCHealth\
ErrorReporting\IncludeKernelFaults

icon Return to top

ER_Enable_Reporting

Specifies whether Windows automatically reports errors.

Syntax ER_Enable_Reporting = 0 | 1
Values 0

Does not report errors.

1

Reports errors.

Example
ER_Enable_Reporting = 1
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\PCHealth\
ErrorReporting\DoReport
Comments If you disable ER_Enable_Reporting and enable ER_Display_UI, the end user cannot report errors.

icon Return to top

ER_Enable_Windows_Components

Specifies whether to report errors in Windows applications.

Syntax ER_Enable_Windows_Components = 0 | 1
Values 0

Reports errors in Windows components.

1

Reports errors in Windows components when you enable ER_Enable_Reporting.

Example
ER_Enable_Windows_Components = 1
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\PCHealth\
ErrorReporting\IncludeWindowsApps
Comments When you enable ER_Enable_Reporting, Setup reports errors for the components that are part of Windows XP and Windows Server 2003 operating systems. To exclude individual Windows components, use ER_Exclude_EXE(n).

icon Return to top

ER_Exclude_EXE(n)

Specifies an application for which Windows does not report any errors, if they occur.

Syntax ER_Exclude_EXE(n) = executable_filename
Value executable_filename

The filename of a Windows component or application that error reporting excludes.

Example
ER_Exclude_EXE1 = notepad.exe
ER_Exclude_EXE2 = explorer.exe
ER_Exclude_EXE3 = iexplore.exe
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\PCHealth\
ErrorReporting\ExclusionList
Comments Only used if you enable ER_Enable_Windows_Components or if ER_Enable_Applications = All.

icon Return to top

ER_Force_Queue_Mode

Specifies whether to send all reports in queue mode.

Syntax ER_Force_Queue_Mode = 0 | 1
Values 0

Does not send reports in queue mode.

1

Sends reports in queue mode.

Default Value Windows Server 2003 family: 1
Windows XP Professional or Windows XP Home Edition: 0
Example
ER_Force_Queue_Mode = 1
Registry subkey HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\PCHealth\ErrorReporting\
ForceQueueMode

icon Return to top

ER_Include_EXE(n)

Specifies whether the error report includes the file name of the application causing the error.

Syntax ER_Include_EXE = executable_filename
Value executable_filename

The file name of an application that includes error reporting.

Example
ER_Include_EXE1 = notepad.exe
ER_Include_EXE2 = explorer.exe
ER_Include_EXE3 = iexplore.exe
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\PCHealth\
ErrorReporting\InclusionList
Comments Requires that ER_Enable_Applications is set to Listed. You can automatically include Microsoft applications by using ER_Include_MSApps.

icon Return to top

ER_Include_MSApps

Specifies whether to track and report errors in Microsoft applications.

Syntax ER_Include_MSApps = 0 | 1
Values 0

Does not report errors in Microsoft applications.

1

Reports errors in Microsoft applications when you enable ER_Enable_Reporting.

Example
ER_Include_MSApps = 1
Registry subkey HKEY_LOCAL_MACHINE\Software\Microsoft\PCHealth\
ErrorReporting\IncludeMicrosoftApps
Comments If you set ER_Enable_Reporting to 1 and ER_Enable_Applications to Listed, Setup reports errors for all Microsoft applications.

icon Return to top

ER_Include_Shutdown_Errs

Specifies whether to report shutdown errors.

Syntax ER_Include_Shutdown_Errs = 0 | 1
Values 0

Does not report shutdown errors.

1

Reports shutdown errors.

Default Value Windows Server 2003 family: 1
Windows XP Professional or Windows XP Home Edition:0
Example
ER_Include_Shutdown_Errs = 1
Registry subkey HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\PCHealth\ErrorReporting\
IncludeShutdownErrs

icon Return to top

RA_AllowFullControl

Specifies whether a person (other than the end user of the computer) can take full control of the computer from a separate location.

Syntax RA_AllowFullControl = 0 | 1
Values 0

Enables remote helper to view the end user's desktop but cannot take control of the end user's computer.

1

Enables remote helper to ask to take control of the end user's computer and the end user can grant this request.

Default Value 1
Example
RA_AllowFullControl = 0
Registry subkey HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\
Windows NT\Terminal Services\fAllowFullControl
Comments The helper must ask the end user for explicit permission to take control; the end user can accept or decline such requests. Requires RA_AllowToGetHelp = 1. If RA_AllowToGetHelp is 0, Setup ignores RA_AllowFullControl.

icon Return to top

RA_AllowToGetHelp

Specifies whether to enable Remote Assistance.

Syntax RA_AllowToGetHelp = 0 | 1
Values 0

Disables Remote Assistance.

1

Enables Remote Assistance.

Default Value 1
Example
RA_AllowToGetHelp = 1
Registry subkey HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\
Control\TerminalServer\fAllowToGetHelp
or
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\
Windows NT\Terminal Services\fAllowToGetHelp
Comments Remote Assistance allows another person to view and share the control of the end user's desktop from a separate location, using Terminal Services, so that person can more easily assist the end user with a technical problem.

End users may request Remote Assistance by escalating a support request to OEM product support from the Help and Support Center. End users may also request Remote Assistance from a friend using MSN® Messenger or Windows Messenger or e-mail.

icon Return to top

RA_AllowUnsolicited

Specifies whether to enable unsolicited Remote Assistance.

Syntax RA_AllowUnsolicited = 0 | 1
Values 0

Disables unsolicited Remote Assistance.

1

Enables unsolicited Remote Assistance.

Default Value 0
Example
RA_AllowUnsolicited = 0
Registry subkey HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\
Windows NT\Terminal Services\fAllowUnsolicited
Comments With unsolicited Remote Assistance, another person within the corporate local area network (LAN) who has administrator-level access to the computer (or one who has a user account with the appropriate level of permissions) may request access to the computer for management or troubleshooting purposes. The end user can accept or decline such requests.

icon Return to top

RA_MaxTicketExpiry

Specifies the time, in seconds, after which a Remote Assistance invitation expires.

Syntax RA_MaxTicketExpiry = time_in_seconds
Value time_in_seconds

The time, in seconds, after which a Remote Assistance ticket expires.

Default Value 2,592,000 seconds (30 days)
Example
RA_MaxTicketExpiry = 600
Registry subkeys HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\
Windows NT\Terminal Services\MaxTicketExpiryUnits
and
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\
Windows NT\Terminal Services\MaxTicketExpiry

icon Return to top