*
Quick Links|Home|Worldwide
Microsoft TechNet*
|TechCenters|Downloads|TechNet Program|My TechNet|Security Bulletins|Archive
Search for


Windows Desktop Search Administration Guide

On This Page
OverviewOverview
Pre-installation considerationsPre-installation considerations
Installing Windows Desktop SearchInstalling Windows Desktop Search
WDS software updatesWDS software updates
Enterprise search integrationEnterprise search integration
Encrypting your indexEncrypting your index
Windows Desktop Search extensibility and programmabilityWindows Desktop Search extensibility and programmability
Customizing WDS by using Group Policy settingsCustomizing WDS by using Group Policy settings
Providing enterprise specific defaultsProviding enterprise specific defaults
Troubleshooting OutlookTroubleshooting Outlook
Additional informationAdditional information
Additional resourcesAdditional resources
Document revision historyDocument revision history

This document is provided for informational purposes only and Microsoft makes no warranties, expressed or implied, with respect to this document or the information contained in it. This document pertains to Windows Desktop Search Version 02.06.0000.2057 and later.

Note Some features are not available in all markets.

Overview

Windows Desktop Search (WDS) helps your business users find almost anything on their computers — e-mail messages, calendar appointments, photos, documents, and more. Searching a computer with WDS is virtually as fast and easy as searching the Web. Additionally, the Desktop Search results window includes rich Windows Explorer features so that your users can quickly preview, filter, and act on search results.

The latest version of WDS is optimized with features that help enterprise information technology (IT) managers deploy and manage the installation of WDS across all users and computers in their organizations.

IT managers can expect the following benefits:

Fast deployment.

WDS supports Microsoft Systems Management Server (SMS), and other similar deployment solutions.

You can distribute WDS like other Windows components through the package installer (formerly Update.exe).

You can easily control software updates.

Easy manageability.

Supports Windows Group Policy.

Supports multi-language user interface (MUI) environment & non-admin users.

WDS is a fully globalized product with MUI support.

WDS is available in thirty languages.

Integration with enterprise search solutions such as SharePoint Portal Server or Windows SharePoint Services (WSS).

WDS adds an “intranet” search option to the Windows Deskbar and the Desktop Search results interface.

Lets you add new data types to search through filters and protocol handlers.

Lets you integrate desktop search results into other business applications by using the desktop search query interface.

Best of all, WDS is free with your Microsoft Windows license (View Windows Supplemental License).

Microsoft Corporation, or one of our affiliates depending on where you live, licenses this supplement to you. You may use a copy of this supplement with each validly licensed copy of Microsoft Windows software identified for use with it (the 'software'). You may not use it if you do not have a license for the software. The license terms for the software apply to your use of this supplement.

This document contains information about how to set up WDS in an enterprise environment. This document targets an audience of IT managers and administrators.

Pre-installation considerations

Before you install Windows Desktop Search, consider the following factors:

System requirements

Localization options

Group Policy options, including:

Assigning network resources to groups

Roaming users

Optimizing WDS for slower or less powerful computers

In this section, we review these factors and the methods that you can use to manage them. Reviewing these issues and methods before you install WDS can help ensure a successful and painless roll-out.

System requirements

A system must meet or exceed the following requirements to run Windows Desktop Search:

Microsoft Windows XP with Service Pack 1 (SP1), Microsoft Windows Server 2003, or Microsoft Windows 2000 Server with Service Pack 4 (SP4)

Note: 64-bit versions of Microsoft Windows are not supported.

Microsoft Outlook 2000 or a later version, or Microsoft Outlook Express 6.0 or a later version to index and search your e-mail

Pentium 500 MHz or faster processor (1 GHz recommended)

Minimum 128 MB of RAM (256 MB recommended)

500 MB of hard disk space recommended (Your index size depends on how much content you index)

Full preview of Microsoft Office documents in Desktop Search results is available only for Microsoft Office XP or later versions of Microsoft Office.

System recommendations

500 MB of hard disk space

The size of your index depends on how much content you index.

1024 x 768 screen resolution

Localization options

If your organization requires localized builds for users who speak different languages, you can either deploy localized versions of WDS, or deploy the English version of WDS and use a Multilingual User Interface Pack (MUI) to switch user interfaces based on the user’s language preference.

You can use the English .adm file to create Group Policy objects (GPOs) for non-English speaking users. For settings that require that you enter text, such as the name of the intranet scope, you should enter the information in the appropriate language.

For your convenience, the WDS .adm file is available in eight languages, including English. This lets local IT administrators read the explanation text in their native languages. It does not matter which localized version of the .adm file you use to create the GPOs.

Group Policy settings

Although you do not have to use Group Policy settings to deploy this software, they can be a very powerful tool to help control access to resources and the functionality of this product. Group Policy settings are supported by WDS version 2.6 or later.

To plan and deploy effective Group Policy settings, your organizational units and groups must be structured logically. A well planned and implemented organizational structure provides far-reaching benefits when you manage security, users, and resources. Group Policy settings can be especially useful when you plan how to most efficiently deploy WDS. It is likely that different organizations in your company have very needs for information and resources. For example, the accounting department may have access to more systems and require more security than the shipping and receiving department.

When you deploy software, the more time that you spend organizing and planning how to best meet the different needs of your users, the better the outcome will be. With WDS you can customize the product to search different resources for each group.

By using Group Policy settings, you can quickly and easily adjust the resources and functionality of WDS. For detailed information about how to use Group Policy settings with WDS, please see the "Customizing WDS using Group Policy settings" section.

Assigning network resources to groups

Because each department and group searches for data differently, you may want to add different search capabilities to different departments. Doing this requires a unique Group Policy setting for each configuration of resources. By using Group Policy settings, you can give users access to various data sources, including Share Point Servers, Share Point Services, Intranet sites, and other data stores. For detailed information about specific settings and how to correctly configure these settings, please see the Windows Desktop Search Policies section, and the Index Policies section later in this document.

Network performance

In typical environments, users can index network shares, e-mail, public folders, and other resources. However, this functionality can come at a cost. When you enable users to index network shares or e-mail and public folders, the network traffic to these locations may increase when these resources are indexed. You may see the most impact to network traffic during the initial index and during incremental index, when the user logs on. The impact on servers is partially reduced by the back-off functionality that is built into WDS. See the Smart Indexer in the Additional Information section for more information about this back-off functionality.

You can use Group Policy settings to modify various aspects of the product and help limit the impact to network traffic. For example, you can disable indexing at startup, disable certain network paths to high volume servers, disable indexing of Public folders, or allow indexing of Microsoft Office Outlook 2003 only in cached mode. These Group Policy settings can help lessen the impact on a network.

Group Policy options are also available that limit the impact on network traffic while still letting your users index the information that they need. For more information about Group Policy options, see the Windows Desktop Search Policies section.

Roaming profiles

Windows Desktop Search does not support Roaming profiles. You may be able to work around this limitation by storing the account profiles of these users on a terminal server. When you do this, users can access their documents, desktop and applications from virtually any computer on the network.

Terminal servers

Windows Desktop Search is supported on terminal servers. However, when you use WDS on a terminal server, consider the following information:

If the same user logs in twice on the same machine, the second session won’t be able to start WDS. This mostly affects administrators who connect to the same machine locally and remotely without logging out.

When many users are on the system at the same time, the following issues may occur:

Indexer performance is reduced because it’s backed off more often. For example one user might be idle, but another user might generate a lot of CPU usage or I/O.

System performance may decrease, especially when users click Index Now or use the Prioritize Indexing option. These options may disable the Back-off feature.

We recommend that IT departments test these scenarios in-house before they deploy them to production environments.

Legacy systems

By using the (.adm) Group Policy file, you can create a Group Policy setting that reduces the impact on system performance while letting users of older computers maintain access to WDS functionality. Remember that indexing lots of information requires more system resources. Therefore, we recommend that you limit how many resources are indexed on these systems.

Installing Windows Desktop Search

The WDS installer is based on the package installer technology. The package installer is used to install software updates for Microsoft Windows operating systems and Windows components. In the past, the package installer was named Update.exe. If you are an IT administrator and are interested in learning more about the package installer, you can review the package installer documentation.

Upgrading earlier versions of WDS

The user or administrator must uninstall earlier versions of Windows Desktop Search before installing the latest version. This affects only version 02.05.xxxx.xxxx or earlier, which is typically installed along with Toolbar. The installation will fail if the earlier versions are on the destination computer. These earlier versions can be uninstalled through remote system management methods. If the current version of Windows Desktop Search is 02.06.0000.xxxx or later, this issue does not occur. Uninstalling the suite and installing WDS enabled for the enterprise edition will not restore the functionality of Toolbar. To ensure that Toolbar is correctly reinstalled after WDS is installed, install the latest version of the Toolbar suite.

To find out which version of WDS is installed on your computer, by right-click the WDS icon in the notification area, click Desktop Search Options, and then click the General option in the tree display. The version number is listed in the Version Information box.

You can use the file name at a command line to uninstall the software. For example, type msiexec /x MSNSearchToolbar.msi at a command line to uninstall the MSN Search Toolbar.

Version history table

The following table lists recent versions of Windows Desktop Search.

WDS versionRelease dateNotes

02.05.0000.1082

20 June 2005

MSN Toolbar suite installed with WDS.

02.05.0001.1119

27 September 2005

MSN Toolbar suite installed with WDS.

02.06.0000.2057

14 November, 2005

First enterprise-class release with support for Group Policy settings. First documented in Microsoft Knowledge Base article 907371. You must uninstall earlier versions of WDS before you install this version.

02.06.0000.2083

4 January, 2006

Fixes issues where some mail messages are not indexed. Documented in Microsoft Knowledge Base article 907371. Package installer is renamed with V2 in the file name.

Installation package

WDS is released as a software package that is a single, self-executable file. The actual name of the WDS installation package is WindowsDesktopSearch-KB907371-V2-x86-XXX.exe, where XXX is the language code. For example, you would use WindowsDesktopSearch-KB907371-V2-x86-ENU.exe for U.S. English.

In an enterprise environment, WDS is typically deployed to multiple desktops across an organization through one of the following deployment tools:

System Management Server (SMS).

Group Policy Software Installation.

Non-Microsoft third-party deployment software.

When WDS is installed, a shortcut is added to the Start menu and to the taskbar for all users of the system. The Windows Deskbar is automatically made available to all users on their taskbars unless it is turned off through Group Policy. WDS runs automatically for each user on the computer whenever that user logs on to the computer. Individual users maintain their own index and search parameters.

What's included

WDS includes the following major components:

WDS Indexer – indexes more than 200 file types and content stores.

Windows Deskbar – provides a search-as-you-type interface to quickly locate items on your desktop.

Desktop Search results view – provides a search results view that lets you easily preview, filter, and act on search results.

Search companion integration – upgrades the Search Companion or Search Assistant in the Windows operating system.

Indexing options – these let you specify what to index, where to index, and more.

Adding functionality with MSN Toolbar

To provide desktop search entry points from inside Microsoft Office Outlook or Microsoft Internet Explorer, you have to deploy the MSN Search Toolbar separately. MSN Search Toolbar adds a new toolbar in Internet Explorer and a new toolbar in Outlook. Both toolbars let users perform a desktop search if WDS is installed. MSN Search Toolbar also provides features to optimize corporate deployments.

Deployment modes

WDS can be deployed in attended mode or unattended mode, depending on the level of interaction you want your users to have with the computer while the installation is in progress. Installations for both modes can be performed through a combination of command-line options. See the package installer command-line options for a full list of supported command-line options.

NOTE: To test command-line options and the behavior of the installation package, click Start, click Run, type cmd, and then click OK. This opens a Command Prompt window where you can test the installer package with various options. We recommend that you uninstall WDS before you try to install it again by using different command-line options.

Command-line options

Command-line OptionsDescription

/quiet or /q

Provides no status dialog box during the extraction. Unless used in combination with /extract or /extract:path, this option directs the installation to run in quiet mode.

/passive or /U

Provides a progress bar during the extraction, but does not prompt you for the destination folder name. Unless used in combination with /extract or /extract:path, this option directs the installation to run in passive mode.

/extract or /X

Extracts package files without starting the installation. Prompts you for the path of the destination folder for extraction. When used together with the /q or /U switch, this option extracts the package file to a randomly named folder on the root folder.

/extract:path_name or /X:path_name

Extracts software update package files to the specified folder without starting the package installer or prompting you for a destination folder. When used together with the /q or /U switch, this option extracts the package file to the specified folder.

/WDSCLOSEOL

Closes Outlook if it is running on the computer when WDS is installed. Without this option, the WDS installation process does not close Outlook, even when you install WDS in unattended mode. WDS installation will continue. However indexing will not start until Outlook is closed and restarted.

Note

The /WDSCLOSEOL option is specific to WDS. This option is not available to other programs that use Update.exe.

Attended mode

Attended mode is the typical installation method for an individually managed environment that requires end-user interaction. If you plan to make WDS available on-demand through an internal IT software download site, you can deploy WDS in attended mode.

In this mode, the Software Update Installation Wizard is started. Your end users must then accept the Microsoft Software License Terms (EULA) and quit open applications when they are prompted to do so. Your end users must restart their computer, as necessary, at the end of the installation process.

When no command-line options are specified, WDS installs in attended mode by default.

Unattended mode

Unattended mode enables the automated installation of software updates. This mode does not require end-user interaction. If you specify the /quiet or /q command-line option, the WDS installation can be completely silent. If a restart is required, the restart occurs automatically. The WDS deskbar appears automatically after the unattended installation finishes. You should also enable the Prevent First Run Customization Wizard Group Policy setting if you do not want users to see the First Run Customization Wizard. You can hide the wizard either by enabling the Prevent First Run Customization Wizard Group Policy setting or by using the /WDSNOLAUNCH command-line switch. If you enable the Group Policy setting, the wizard will not run during installation or during first run. The /WDSNOLAUNCH command-line switch disables the First Run Customization Wizard by preventing WDS from starting at the end of the installation process. However, this command-line switch doesn’t stop the wizard from running the next time that the user logs in to the system.

You can also specify the /passive or /u command-line option. This provides you with a progress bar and warns you that a restart will occur if one is necessary. Additionally, passive mode installation will display any errors that you may encounter. You should also disable the “Prevent First Run Customization Wizard.”

If Outlook is running while WDS is being installed in unattended mode, Outlook will not quit as part of the installation process. The WDS installation process will continue. However, indexing will not start until you quit and then restart Outlook.

Use the /WDSCLOSEOL command-line switch if you want Outlook to close while WDS installs in silent or passive mode.

There are several ways to accomplish unattended installation. These include developing custom batch installations by using the previously mentioned command-line options, or by using automation software, such as SMS or Windows Update Services, to install software updates on all computers across a network.

If you manually install a software update, the installation runs in the user context. You should be an administrator with the user permissions that are specified in the “Required User Right” section of the package installer documentation. If a software update is deployed through SMS or Windows Update Services, the package installer is spawned in the System context because the parent process runs as a service.

Examples of commonly used extraction options

The table in the Command-line options section details common extraction options and their functions. After extraction, the files reside in the specified folder. If no folder is specified and the command-line option /extract was used with /passive or /quiet, a randomly named folder (for example, 1ed6b742f546f) is generated, and the setup files are placed there. When installation is finished, these files and the folder are removed.

The following table provides examples of commands you can use to extract the contents of a software update package.

ExampleDescription

WindowsDesktopSearch-KB907371-V2-x86-ENU.exe /q /x:C:\WDS

Extracts and installs the contents of the package to a newly created folder named WDS on drive C.

WindowsDesktopSearch-KB907371-V2-x86-ENU.exe /extract

Extracts the contents of the package to a randomly generated folder in the root folder of the current drive.

Deploying WDS through Group Policy

You cannot directly deploy package installer/update.exe based Windows components through Group Policy. If you need to use Group Policy, you must write a deployment wrapper, such as an MSI package, that contains the WDS executable file.

Note: Microsoft does not support repackaging software updates with a different installer. This includes modifying the current update.exe package headers, files, or installation information to conform to another deployment method. However, placing the package in a wrapper, such as an MSI wrapper, is supported. The package installer and the Windows Installer are not interchangeable. Packages that are built with one installer technology have been tested and optimized to work only with that technology.

WDS software updates

To obtain the latest versions of WDS, you must check for updates on the WDS website. If you use a WSUS server, you control when updates are applied to most Windows components. If you use SMS or other deployment technologies for updates, you have full control over updates.

The Hide Check for Update Link Group Policy setting lets you hide the Check for updates link on the WDS Help menu. This setting sends the user to the WDS website.

Aside from making the business decision about whether to enable this policy, there is no additional configuration required to manage your own updates to WDS in a locked enterprise environment.

Enterprise search integration

WDS provides you with settings so that you can start intranet searches to your enterprise search solution from within Windows Deskbar and WDS results view. Examples of enterprise search solutions include Microsoft Share Point Portal Server or Windows SharePoint Services (WSS).

Your users can benefit by:

Easily starting an intranet search from the Windows Deskbar.

Easily switching between search results from the desktop, intranet, and the Web from the Desktop Search results view.

Quickly searching multiple intranet locations configured by the IT administrator.

Additionally, all web searches initiated from WDS use the default search provider of your user's default browser.

All intranet-related settings are documented in the Search category in the Policy section.

Encrypting your index

The WDS index is lightly encrypted so that it is not easily readable if someone tries to open the index file. To strongly encrypt the WDS index, you will have to place it in the Encrypting File System (EFS). EFS provides the core file encryption technology that is used to store encrypted files on NTFS file system volumes. EFS helps protect files from intruders who might gain unauthorized physical access to sensitive, stored data (for example, by stealing a portable computer or an external disk drive).

Windows Desktop Search extensibility and programmability

WDS provides a number of extensibility and programmable interfaces to help enable these additional scenarios for enterprise customers:

Let your users search file types specific to your company or industry, such as CAD files or PDF files, by deploying IFilters.

Let your users search additional content repositories from proprietary applications by writing and deploying protocol handlers.

Integrate desktop search results in your own business application by using the desktop search query API. For example, you can provide sales reps with a complete profile of their clients in your customer relationship management (CRM) system by combining CRM data with information about the client that is stored on the sales rep’s local computer.

For more information, see the WDS developer’s guide.

View a list of available third-party filters and protocol handlers that can be integrated with WDS.

Customizing WDS by using Group Policy settings

Group Policy overview

This version of WDS fully supports Windows Group Policy. Administrators can use Group Policy to deliver and apply one or more preferred configurations or policy settings to a set of targeted users and computers within an Active Directory directory service environment. The Administrative Template files (.adm files) provide the majority of available policy settings and are designed to modify specific keys in the registry. This is known as a registry-based policy. You will need to obtain the WDS .adm file to configure and enforce certain WDS settings through Group Policy.

The following is a summary of the steps that you must take as a Group Policy administrator to configure WDS with Group Policy:

1.

Create an environment that supports the efficient application of Group Policy. This step concerns the design of their Active Directory domain, sites and Organizational Units. Precisely how you implement this step depends on the administrative structure of your company.

2.

Create a Group Policy object that contains the appropriate policy settings. By using the Active Directory management console or the Group Policy Management Console (GPMC), you can create and edit your Group Policy object to contain one or more policy settings for WDS and for any other Group Policy-aware programs. At this stage no users or computers are affected by the GPO.

3.

Scope the GPO. Before the GPO is linked (see the next step), you can fine-tune which computers and users are affected by using security filtering (specifying which AD security groups should receive the GPO) or WMI filtering (allows the selection of a wide range of client-side criteria to decide whether the GPO should be applied).

4.

Link a GPO to a “Scope of Management” (SOM). An SOM is an Active Directory domain, site, or OU. As soon you link the GPO to an SOM, the GPO affects all computers and users in that SOM.

See Microsoft Technet for more Group Policy information.

Obtaining the Windows Desktop Search Group Policy file

The WDS .adm file is available for download here. You may have to right-click the download link and click Save Target As to download the file. Only WDS version 2.6 or later provides Group Policy support. Therefore, make sure that you are deploying WDS version 2.6 or a later version. After you have downloaded the .adm file, you can edit it in the Group Policy Management Console (GPMC).

The WDS .adm file is named "DesktopSearch.adm".

After you import the .adm file into GPMC, you will see a Windows Desktop Search node added under the Administrative Template tree.

All WDS policies are supported as both machine and user policy settings to help provide optimum configuration flexibility. We recommend that you implement each setting as either a machine or a user policy, but not as both.

WDS policies are organized into three categories:

Setup - policies about Setup, such as whether to show or hide certain components, such as the First Run Customization Wizard.

Index - policies about what to index, where to index, and so on.

Search - policies about Web search settings, intranet search settings, and more.

Windows Desktop Search Policy location

All policies are created under one of the following sections of the registry:

Machine policy settings: HKLM\Software\Policies

User policy settings: HKCU\Software\Policies

WDS adds a sub key to each location in which WDS policy settings will reside.

WDS Machine policy settings: HKLM\Software\Policies\Microsoft\DesktopSearch

WDS User policy settings: HKCU\Software\Policies\Microsoft\DesktopSearch

This key is added to the policy section only when a policy is applied. Therefore, if no policies are applied, the key will not be present. Whenever possible, all registry sub keys and values will parallel the corresponding WDS machine and user preferences sections of the registry.

Installing international versions

If your organization requires localized builds for users who speak different languages, you can either deploy localized versions of WDS or deploy the English version of WDS and then download and install the Multilingual User Interface (MUI) Pack. This allows your users to switch user interfaces based on the user’s language preference.

The WDS MUI Pack cannot be installed with a non-English version of WDS. You must install the English version of WDS, and then install the WDS MUI Pack. This means that if the WDS MUI Pack is already installed on a computer, you cannot install a non-English version of WDS on the same computer.

Installing Windows Desktop Search with the MUI Pack

Windows Desktop Search MUI works together with Windows MUI. For best results, we recommend that you install the Windows MUI before you install the WDS MUI. When the Windows UI language is changed, the WDS UI language changes to the same language.

best results, follow these steps when you install WDS with the MUI Pack:

Install the Windows MUI Pack.

Install WDS.

Install the WDS MUI Pack.

Change the Windows Regional and Language options. To do this, follow these steps:

Click Start, and then click Control Panel.

Double-click Regional and Language Options, click the Languages tab, and then click Details.

Click the language that you want to use, and then click OK.

Log off and then log on again as the same user.

The WDS UI will use the same language that you selected in the Regional and Languages Options item in Control Panel.

You can download the MUI Pack from the following Microsoft website:
http://www.microsoft.com/windows/desktopsearch/enterprise/downloads.mspx

For more information about the Windows MUI Pack, visit the following Microsoft website:
http://www.microsoft.com/globaldev/reference/win2k/setup/default.mspx

General policy setting behavior

All WDS policy settings will be described in detail. However, WDS policies generally share the following attributes:

Real-time refresh. As soon as the policy is applied and WDS receives a notification of the policy change, WDS will automatically refresh to enforce the settings. The user does not have to quit and restart the application or log on to Windows again for the new policy to take effect. For some policies, the settings may take effect when the policy is applied, but the information that is indexed may not be affected until the next time that the user logs on or until the next indexing session occurs.

Index purges for most indexing related policy settings. If you enable policies to prevent the indexing of certain content, such as Outlook data, the index is automatically purged and rebuilt at the next startup. For example, if after the initial deployment, you decide to prevent Outlook indexing for business specific, regulatory, and compliance reasons, this ensures that Outlook data that has already been indexed is purged. The only exceptions are the policies that specify which files to index as text and the policy that specify which file types to exclude. If you subsequently modify these policies, the content that has already been indexed is not purged.

Adhering to system policies

In general, WDS is built on common Windows components. Therefore, WDS adheres to system-level policies that your organization may have enabled. There are two specific system-level policies that are relevant to the Windows Deskbar, as follows.

Remove the Run command from Start menu

Description

When this policy is enabled, the system removes the Run command from Start menu and prevents users from opening the Run dialog box by pressing the Windows logo key + R.

Application action

If your application has a function that allows a user to start a program by typing its name and path in a dialog box, your application must disable that functionality when this policy is enabled.

WDS Behavior

Automatically turns off the alias feature in Windows Deskbar.

Automatically turns off run operation (=operation) in Windows Deskbar.

Automatically removes My Deskbar Shortcuts section from Deskbar.

Run only allowed Windows-based applications

Description

When this policy is enabled, users can run only those applications that are listed under the RestrictRun value.

Application action

Your application must not start any application that is not on this list. However, this does not apply when you start applications through COM. If you use ShellExecuteEx, the system will perform this check automatically.

WDS Behavior

Windows Deskbar only starts applications that are on the Restrict Run list.

Windows Desktop Search Policies

This section outlines all the policy settings available for WDS.

Setup Policies
Policy SettingDescription

Turn off Windows Deskbar

Enabling this policy hides the Deskbar from the Windows taskbar. Users cannot show this toolbar because it does not appear as an entry under Toolbars when the user right-clicks the taskbar.

Note: The Deskbar is still installed as part of the WDS setup.

Enabling this policy also removes the corresponding display option in the Customization Wizard.

When this policy is disabled or not configured, the Deskbar is made visible according to the preference that the user sets when the customization wizard runs. The user has the option to show or hide this toolbar.

Hide Check for Update Link

Enabling this policy prevents Windows Deskbar and Desktop Search Options from showing the Check for Update link under the Help menu. If you use a WSUS server, SMS, or other deployment technologies for updates, you have full control over updates without enabling this policy. This setting only hides the Check for Update link.

If this policy is disabled or not configured, WDS displays a link under the Help menu so that users can check for updates directly.

Turn off First Run Customization Wizard

Enabling this policy turns off the First Run Customization Wizard. All users who log on for the first time after WDS is installed do not see the First Run Customization Wizard.

Most options in this wizard can be enforced through Group Policy settings.

If these settings are not configured through Group Policy, the defaults or machine preferences are used.

When this policy is disabled or not configured, all users see the First Run Customization Wizard after installation and when the index first starts.

Prevent Sending Usage Data through CEIP Program

Enabling this policy prevents WDS from sending anonymous usage data to Microsoft. When this policy is enabled, users do not participate in the Microsoft Customer Experience Improvement Program (CEIP).

If you enable this policy, the First Run Customization Wizard does not ask users to opt in to CEIP.

When this policy is disabled or not configured, the user can choose whether or not to participate in the CEIP program as part of the First Run Customization Wizard that is started for each new user on the computer. By choosing to participate, the user allows anonymous usage data to be sent to Microsoft.

Disable the Rebuild Index Button in the Options Window

Enabling this policy disables the Rebuild Index button in the Desktop Search options dialog. When this policy is enabled, users are not allowed to press the Rebuild Index button.

When this policy is disabled or not configured, the user is allowed to press the Rebuild Index button.

Note You can still rebuild the index by passing the /Rebuild command line parameter to WindowsSearch.exe.

Index Policies
Policy SettingDescription

Prevent Automatically Running WDS When User Logs On

Enabling this policy prevents the indexer from starting when the user logs on to Windows.

You should consider enabling this policy if you are concerned about indexing performance on less powerful computers, or if you are interested in preventing the index from starting after the user logs in.

When this policy is disabled or not configured, the user can select their preferences. If you enable and then disable this policy, the user's original preference is restored.

Index only E-mail and My Documents

Enabling this policy only allows the user to select items to index in their Outlook and Outlook Express e-mail and My Documents folder. It prevents the user from indexing other parts of the hard drive, even though they may have access.

In the Desktop Search options, the e-mail and all hard drive options are dimmed, and the e-mail and My Documents option is selected. The Custom Folders option is available, but the user can only select items from accessible locations.

If you enable the system policy "Hide these specified drives in My Computer", it is strongly recommended that you also enable this policy to prevent unwanted drives from showing in Desktop Search options.

When this policy is disabled or not configured, users can index any location on the hard drive that they have permissions to. If you enable and then disable this policy, the user's original preference is not restored

Prevent Indexing of Outlook

Enabling this policy prevents the indexing of Outlook items.

In the Desktop Search options, the E-mail and hard drive and E-mail and my documents options are dimmed. The custom folders option is selected. The user does not see Outlook when the user browses through items to index.

When this policy is disabled or not configured, the user can choose whether or not to automatically index Outlook. The default is to automatically index Outlook. If you enable and then disable this policy, Outlook indexing remains turned off until the user manually enables it.

Prevent Indexing of Outlook Express

Enabling this policy prevents indexing Outlook Express items.

In the Desktop Search options, the E-mail and hard drive and E-mail and my documents options are dimmed. The custom folders option is selected.

The user does not see Outlook Express when the user browses through items to index.

When this policy is disabled or not configured, the user can decide whether or not to automatically index Outlook Express items. The default is to automatically index Outlook Express items. If you enable and then disable this policy, Outlook Express indexing is automatically enabled for your users.

Prevent Indexing of Public Folders

Enabling this policy prevents indexing public folders in Outlook. Note that WDS only indexes public folders in cached mode in Office 2003 when the Download public folder favorites option is turned on.

When this policy is disabled or not configured, the user has the option to index public folders in Outlook 2003 in cached mode.

If you enable and then disable this policy, public folders remain unindexed until the user has re-selected the public folders to index.

Prevent Indexing of Uncached Exchange Folders

Enabling this policy prevents indexing Exchange in uncached mode.

Outlook Versions prior to 2003 do not support cached mode. All indexed items are downloaded directly from the Exchange server.

If you are concerned about performance, consider enabling this policy. Your users will only be able to index Outlook items, such as PST or cached Exchange items, on their local computers.

When this policy is disabled or not configured, the user can decide whether to index their uncached folders on Exchange. By default, Exchange items are indexed regardless of whether they are cached.

Prevent Indexing of E-mail Attachments

Enabling this policy prevents users from indexing the content of e-mail attachments in Outlook. The file name of the e-mail attachment is still indexed.

You should consider enabling this policy if you are concerned about security or indexing performance on less powerful computers.

When this policy is disabled or not configured, the user can select whether to index e-mail attachments. If you enable and then disable this policy, the user's original preference for indexing e-mail attachments is restored.

Prevent Indexing of Certain File Types

Enabling this policy allows you to edit the list of file types to exclude from indexing.

The end user cannot modify this list. You should separate each extension type with a semicolon.

Note that limitations of Group Policy Object Editor require this list to be split across multiple values. Desktop Search combines all these into a single exclusion list.

When this policy is disabled or not configured, the user can edit the default list of excluded file types. If you enable and then disable this policy, the user’s original list is restored.

Specify File Types to Index as Text

Enabling this policy allows you to edit the list of file types to be indexed as text files. The user cannot modify this list. You should separate each extension type with a semicolon.

Note that limitations of Group Policy Object Editor require this list to be split across multiple values. Desktop Search combines all these into a single index as text list.

When this policy is disabled or not configured, the user can edit the list of files to index as text. If you enable and then disable this policy, the user’s original list is restored.

Specify Location of Windows Desktop Search Index

Enabling this policy allows you to override the default location for each user’s index. If the user already has an index, the index is moved to the new location. System environment variables set on this computer (for example, %HOMEDRIVE%) can be used in the path as well. For example, %HOMEDRIVE%\WDSIndex.

If the path you specify is invalid for a specific user, it will default back to the original index location at:

C:\Documents and Settings\$username\Local Settings\Application Data\Microsoft\Desktop Search

When this policy is disabled or not configured, the user’s default index location is C:\Documents and Settings\$username\Local Settings\Application Data\Microsoft\Desktop Search. If you enable and then disable this policy, the user's initial default location preference is not stored.

If you want to specify an initial default index location but allow users to change it later, see the administration guide for how to set up the initial machine preference.

Note If an invalid Path is specified, WDS generates the following error message:

There is not enough disk space available on the destination drive to move the index.

The error message may also appear when you add or modify other policies until the erroneous path is corrected.

Prevent Indexing of Any Network Shares

Enabling this policy prevents the indexing of any network shares. This includes drives that are mapped to network shares. The user will receive an error message if they try to add any networks shares, even if they have permissions. Use this option if you are concerned about unnecessary load on network shares.

When this policy is disabled or not configured, users can specify any additional network shares they want to index as long as they have permissions to do this.

Prevent Indexing Certain Paths

Enabling this policy allows you to specify a list of local and network paths to exclude from indexing. The user cannot enter any network share that starts with one of the paths you specified.

If you enable and then disable this policy, users can index any network share, but their original list of network shares to index is not restored.

Index Certain Paths

Enabling this policy allows you to specify an initial list of paths that are indexed for each user. This policy serves as an initial configuration for users, but users can modify these defaults later if they want. Any indexing-prevention policies (such as Prevent Indexing Network Shares or Prevent Indexing Certain Paths) take precedence over this policy.

Any system environment variable can be used in the specification of these paths. For example:

\\docserver\docs\%username%

Hide Advanced Indexing Options

Enabling this policy hides all advanced indexing options from the Desktop Search Options view.

It removes the Advanced sub-section from the options tree.

You should consider enabling this policy if you think that your users will have a hard time understanding the advanced Desktop Search options or you plan on enforcing all advanced options through Group Policy.

When this policy is disabled or not configured, the user can configure their advanced options.

Stop Indexing on Limited Hard Drive Space

Enabling this policy prevents indexing from continuing as soon as there is less than the specified amount of hard disk space left on the same drive as the index location. Select a value between 0 and 2147483647 MB.

Enable this policy if computers in your environment have extremely limited hard disk space.

When this policy is disabled or not configured, WDS will automatically manage your index size.

Prevent Unwanted IFilters and Protocol Handlers

Enabling this policy prevents Windows Desktop Search from using IFilters and Protocol Handlers unless they are specified in the "allow" list. However, this policy will not prevent IFilters or Protocol Handlers from being installed, nor will it prevent them from being used by other applications or services.

To specify an Allow list of add-ins, provide the class ID string. For example, if you plan on deploying the Adobe IFilter, make sure that this IFilter (enter its GUID formatted as "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}" including the braces) is on the allow list.

Note: Because of a limitation in the Group Policy editor, you must add at least one entry in the allow list. If a blank entry is made in the allow list, it will accept it. However it will also stop WDS from indexing even the default file sets that were originally configured with WDS. When you use this policy, WDS uses only the IFilters and Protocol Handlers that are listed in the allow list. If this list contains only a white space, you effectively instruct WDS not to use any IFilters or Protocol Handlers, severely limiting the functionality of WDS. For more information about configuring this policy, see the Troubleshooting Group Policy settings section.

If you maintain a locked desktop environment, this setting is redundant because non-admin users do not have permission to install new components. If your users have administrator permissions or can install software, this policy prevents them from specifically adding WDS related add-ins.

Search policies
Policy SettingDescription

Add Primary Intranet Search Location

Enabling this policy allows you to add a primary intranet search location within WDS. The value of this text should be:

name,url

You must provide the following:

1.

A name for the scope, such as 'Intranet'.

2.

The URL to the search service. Use $w in place of the query term for the search service URL.

If your intranet search service is SharePoint Portal Server, your query should resemble the following: http://sitename/Search.aspx?k=$w

If your intranet search service is Windows SharePoint Services (WSS), the query should resemble the following, where XXXX is the locale ID of your WSS Service. For example, the English locale ID is 1033.

http://sitename/_layouts/XXXX/searchresults.aspx?SearchString=$w

This adds the intranet search location to:

Windows Deskbar

Desktop Search results search box

WDS search box in Search Companion

Add Secondary Intranet Search Location

Enabling this policy allows you to add intranet search locations in addition to the primary intranet search location defined in the 'Add Primary Intranet Search LOCATION' policy. The value of this text should be:

name1,url1;name2,url2;...nameN,urlN

For example:

MySearch,http://mysearch.aspx?q=$w;MySearch2,http://mysearch2?q=$w.

Note There should be no spaces after the comma between the name and the URL. Adding one or more spaces after the comma will cause your URL to be invalid.

For each search scope, provide the following:

1.

A name for the scope, such as 'IT Web'.

2.

The URL to the search service. Use $w in place of the query term for the search service URL.

If your intranet search service is SharePoint Portal Server, your query should resemble the following:

http://sitename/Search.aspx?k=$w

If your intranet search service is Windows SharePoint Services (WSS), the query should resemble the following, where XXXX is the locale ID of your WSS Service. For example, the English locale ID is 1033.

http://sitename/_layouts/XXXX/searchresults.aspx?SearchString=$w

These additional intranet search locations will be added to the Desktop Search results All Locations drop down.

Preview Pane Location

Enabling this policy allows you to set the location of the preview pane in the Desktop Search results. You can also turn off the preview pane. The four options are:

- Auto

- Right

- Bottom

- Off

You should consider enabling this policy to turn off the preview pane if your environment does not support Office XP or later versions of Office. The full preview pane functionality is only available for Office documents in Office XP or later versions of Office.

When this policy is disabled or not configured, the preview pane automatically appears to the right of the Desktop Search results, and your users can choose the location of the preview pane.

Set Large or Small Icon View in Desktop Search Results

Enabling this policy allows you to specify whether you want large icon or small icon view for your Desktop Search results. The two options are:

Large Icon

Small Icon

If you have disabled the preview pane because your organization does not support Office XP or later versions of Office, you should enforce the large icon view so that users can see snippets related to their desktop search query.

When this policy is disabled or not configured, the default is small icon view.

Turn off Saving Search History in Deskbar

Enabling this policy prevents your search history in Windows Deskbar from being saved.

The Save History option will not appear in the Deskbar options.

When this policy is disabled or not configured, the user can select whether to save their search history.

Do Not Replace Search Companion with Windows Desktop Search

Enabling this policy prevents WDS from replacing Windows Search Companion functionality.

When this policy is disabled or not configured, WDS will replace the Search Companion unless turned off by the user.

If this policy is enabled and then disabled, the user's original preference for Search Companion is restored.

Providing enterprise specific defaults

Policies are generally enforced, implying that if you enable a policy, the user is not allowed to change the setting. In this scenario, the corresponding setting typically appears dimmed or non-existent (or an error message is displayed) if the user tries to change the setting.

However, in certain business scenarios, the IT administrator may only be interested in changing the out-of-box default settings to provide enterprise specific defaults that the user can later change.

For example, consider the following scenario. WDS indexes e-mail attachments out-of-box. You prefer not to index e-mail attachments for some business reasons. But you don’t mind providing the choice so that users who really want to index e-mail attachments can do so. However, if you were to enable the "Prevent Indexing of E-Mail Attachments" policy, you would prevent everyone from indexing attachments.

In this scenario, you can specify your enterprise default settings by providing machine preferences in the registry. You will have to publish scripts to push theses machine preference registry keys to your computers.

All WDS machine preferences are located in the following section of the registry:

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Desktop Search\DS

Although the root is different, policy settings parallel machine preferences locations in the registry. Certain settings only make sense as enforced policy settings; therefore, they have been removed from the machine preference table below.

Index preferences
Machine preferenceRegistry Key HKLM\Software\ Microsoft\ Windows Desktop Search\DSType

Prevent Automatically Running WDS When User Logs On

PreventRunAtStartup

REG_DWORD

Prevent Indexing of E-mail Attachments

PreventIndexingEmailAttachments

REG_DWORD

Prevent Indexing of Certain File Types

DontIndexTheseExtensions0

DontIndexTheseExtensions1

DontIndexTheseExtensions2

DontIndexTheseExtensions3

REG_SZ

REG_SZ

REG_SZ

REG_SZ

Specify File Types to Index as Text

TreatAsText0

TreatAsText1

REG_SZ

REG_SZ

Specify Location of Windows Desktop Search Index

IndexLocation

REG_SZ

Specify whether to index E-mail and My Documents or email and all hard drives

WhatToIndexUISelect

0 = Index E-mail and all hard drives

1 = System default. Index E-mail and My Documents.

REG_DWORD

Search preferences
Machine preferenceRegistry Key HKLM\Software\ Microsoft\ Windows Desktop Search\DSType

Do Not Replace Search Companion with Windows Desktop Search

DisableReplacingStartSearch

REG_DWORD

In general, WDS uses the following logic to determine the precedence of settings:

If machine policy exists, use this

If user policy exists, use this

If user preference exists, use this

Else use machine preference

Troubleshooting Outlook

If your end-users run into issues with WDS that you cannot resolve, please contact Microsoft Help and Support.

If you have additional questions about deploying WDS in your organization, you can use the following resources:

Microsoft Help and Support.

Your Microsoft account representative.

The WDS newsgroup.

Here are some helpful troubleshooting tips:

Outlook items are not indexed

There are several reasons why Outlook items are not indexed. To troubleshoot, use the following methods:

Make sure that Outlook is open and running. This is necessary for indexing to occur.

If you are installing Windows Desktop Search on computers that have more than 1 GB of memory, we strongly recommend that you install the fix described in Microsoft Knowledge Base article KB900628. If you’ve already deployed this fix to your clients, and then subsequently deployed Office Service Pack 2 (SP2), we recommend that you deploy the fix again. This helps to make sure that Office SP2 does not overwrite the fix files.

WDS includes an Outlook add-in for indexing Outlook items. Make sure that this add-in is enabled. To do this, navigate to Help->About Microsoft Office Outlook. Click the Disable Items button, and make sure the WDS Outlook add-in is not on the list. Note that Outlook occasionally prompts the user to disable all add-ins if Outlook is not functioning properly.

PST folders that are not explicitly loaded into Outlook are not indexed. Verify whether your PST folders are loaded into Outlook.

Only the default Outlook profile is indexed. If you have multiple profiles, verify whether you are working with the default profile.

E-mail messages that are attached as items instead of as .msg files are not indexed. If a message is saved as a file and then attached, the attachment will be indexed.

If an Outlook folder is moved after the initial index is completed, the items in that folder will no longer appear after the next index. This is a known issue in earlier versions of WDS and is fixed in version 02.06.05. If your organization is experiencing this issue, please update to the latest version of Windows Desktop Search.

MAPI logging

Windows Desktop Search provides additional troubleshooting for Outlook by using Messaging Application Program Interface (MAPI) logging. To enable MAPI logging, create the LogLevel.MAPI registry entry in the following registry subkey:

HKCU\Software\Microsoft\Windows Desktop Search\LogLevel.MAPI

The registry entry is of type DWORD. To enable logging, set the Value to 0. To disable MAPI logging, set the Value to 4.

When you enable this registry entry, by default, a Mapi.txt file that contains the log information is written to the following folder:

C:\Documents & Settings\%username%\Local Settings\Application Data\Microsoft\Desktop Search\Logs

Outlook 2003 downloads full message bodies and attachments when it is set to download only headers

When Outlook 2003 runs in Exchange Server Cached mode, Outlook may download entire message bodies, even when it is set to download only headers. This behavior may occur regardless of whether the WDS indexer is active or in Snooze mode. This issue may be caused by any of the following:

You have configured ActiveSync to synchronize your e-mail to your PDA device. When ActiveSync synchronizes your e-mail, it can override the Outlook option to only download header information. This issue is described in Knowledge Base article 821299.

Outlook rules or other category-based rules can cause entire messages to be downloaded. This issue is described in Knowledge Base article 826487.

You have multiple e-mail accounts configured in Outlook. This issue is described in Knowledge Base article 892449.

We are working to resolve this issue.

Troubleshooting Outlook Express

Note: Outlook Express must be running for WDS to correctly index items in Outlook Express.

WDS fails silently when you open IMAP Header items in Outlook Express

When Outlook Express downloads message headers from an IMAP mail server, WDS indexes the headers and the complete mail messages. When you perform a search, the message headers appear in the search results. When you double-click a message header, WDS cannot retrieve the entire message body and does not open the message. When this issue occurs, you do not receive an error message. To work around this issue, download the entire message body, or index only folders that contain complete messages.

Troubleshooting Group Policy settings

General troubleshooting

When you troubleshoot WDS Group Policy settings, it is a good idea to double-check the existing values against the examples in the Policies Matrix in theWindows Desktop Search Policies section. Problems are often caused by a mistyped value, an invalid value, an extra space, or by a similar error.

Using the Prevent Unwanted IFilters and Protocol Handlers Group Policy setting

The Prevent Unwanted IFilters and Protocol Handlers Group Policy setting can help a system administrator manage the type of content that is indexed. Different kinds of documents and stores use different kinds of filters and protocol handlers. By restricting the kinds that are allowed in your enterprise, you can effectively block certain types of content.

When you apply this policy setting, you must enumerate the GUIDs to allow the filters. An item that's not in your allow list won't be used by WDS. This policy does not remove or disable the filter for use by other applications, such as Share Point Server (SPS) or Windows Share Point Services (WSS). The policy only prevents WDS from accessing the filters.

The following GUIDs are used for the default file types that are provided with Windows Desktop Search:

TypeGUIDFile types enabled
IFilter{5645C8C2-E277-11CF-8FDA-00AA00A14F93}MIME E-mail messages
IFilter{f07f3920-7b8c-11cf-9be8-00aa004b9986}Office Files
IFilter{e0ca5340-4534-11cf-b952-00aa0051fe20}HTML
IFilter{A373F3D4-7B87-11D3-B1C1-00C04F68155C}Text Filter
Protocol Handler{c1243ca0-bf96-11cd-b579-08002b30bfeb}
Protocol Handler{c3278e90-bea7-11cd-b579-08002b30bfeb}

When you use Policy Manager to edit this policy, make sure that you enter these GUIDS in the allow list. When you type the GUIDs, make sure that you include the braces { }. The braces are required.

If an IFilter is associated with a file type, the file type is registered in the following registry subkeys:

HKEY_CURRENT_USER\Software\Classes

HKEY_CURRENT_USER\Software\Microsoft\RSSearch\ContentIndexCommon\Filters\Extension\

For example, if .EXT is the extension that you want to find, the file type will be registered in the ext entry and the .EXT entry in these subkeys. The value of .EXT is the GUID for the file type in the values of CachedFilterIID or Default ,respectively.

To disable the indexing of a subset of file types that are handled by a particular IFilter or protocol handler, you can use the Prevent Indexing of Certain File Types Group Policy setting. This setting stops WDS from indexing a certain type of file, while continuing to allow the IFilter to index other file types that are handled by the IFilter or the protocol handler.

Using the Prevent Indexing Certain Network Shares Group Policy setting

When you use the Prevent Indexing Certain Network Shares Group Policy setting, make sure that the excluded path has a unique name. When you exclude a share, this policy matches other shares that contain the excluded path as part of their path name. For example, when you exclude \\MyServer\Share, \\MyServer\Share1 will also be unavailable in the Indexing section in Desktop Search Options.

Suppose you map the share \\MyServer\Corp to the Z: drive. If you add a policy setting to prevent \\MyServer\Corp\Share from being indexed, the Share folder will be unavailable in the Indexing Options dialog for the Z: drive. Also, you will be unable to individually select Z:\Shared, Z:\Share1, and similar shares. If you then select the root of the Z: drive, all subfolders except for Z:\Share will be defined by the policy setting. Any other folder under the Z: drive that does not start with “Share” will not be affected. To work around this situation, make sure that the excluded folder has a unique name such as Z:\IShare. In this example, the “I” breaks the pattern match for the path to Z:\share1 or Z:\Shared. If you use this workaround, other peer-level folders will not match the path of the excluded folder.

Using the Add Secondary Intranet Search locations Group Policy setting

When you use the Add Primary Intranet Search Locations policy followed by the Add Secondary Intranet Search Locations policy, you must first close all search windows before the new locations are visible in the All Locations section of the WDS results view.

Error: There is not enough disk space available on the destination drive to move the index

This error message may occur if the Specify Location of Windows Desktop Search Index Group Policy setting is enabled by using the .adm file with an invalid path.

In this situation, you receive the error message when you start WDS, and when any other policy setting is added or changed. To correct this situation, correct the path for the indexer, or disable the policy setting.

Moving the index to a network share or mapped drive may cause the indexer to fail

After the index is built, you can move it by clicking the Change button in the Index Location area in the Advanced settings of Desktop Search Options. If the new location is a network share or a mapped network drive, the indexer may fail when you click the Rebuild Index button. If the indexer fails, you may have to uninstall and then reinstall Windows Desktop Search. We recommend that you keep the index on the local computer. Keeping the index on the local computer can decrease network traffic and help prevent network issues that affect your index or your ability to access it.

General troubleshooting for WDS

Using antivirus and antispyware with WDS

Because WDS indexes the user's system, antispyware or antiadware applications may remove or disable parts of WDS. Although this is not a typical problem with most antivirus software packages, it is worth noting.

We strongly recommend that you test WDS on a standard desktop image before you deploy WDS to your company or engage in a pilot program. This desktop image should contain all the software that is commonly used at your company. By testing WDS in a controlled environment, you can isolate and prevent conflicts between WDS and your security software.

For performance reasons, we also suggest that you exclude the WDS program files, index files, and services from the list of items and places that are scanned.

The Quick Launch section of the Task Bar disappears on multiuser systems

On a multiuser system, the Task Bar may be hidden in some users’ profiles. This issue may occur if a user uninstalls the Quick Launch bar in Windows Desktop Search. To reinstall the Quick Launch bar, follow these steps:

Right-click the Task Bar.

Click Toolbars, and then click Quick Launch.

WDS seems to use a lot of memory

After you install WDS, you may notice that the amount of committed memory appears to increase by as much as 180 MB. This is because the indexer uses memory mapped files. When the indexer maps a large index file to its own virtual memory space, committed bytes increase. This does not affect the memory available to any other process because pages are mapped to the index and not to the paging file. These pages are loaded on demand and only when they are required. Therefore, when you view the working set of processes for WDS, they don't appear to use as much space as the committed bytes.

WDS fails silently when the network connection is lost

When a user successfully indexes a network resource, and then loses the connection to that resource, the indexed items on that resource still appear in WDS searches. If a user selects an indexed item that the system cannot connect to, WDS does not retrieve the item, and you do not receive error message. This issue is scheduled to be resolved in a future release.

Indexes are damaged or deleted

If a WDS index is damaged or deleted, it will be recreated the next time that you start WDS. However, this causes WDS to reindex the computer and other resources. Depending on how many resources must be indexed, the index may not be restored for some time.

In earlier versions of WDS, when WDS cannot correctly re-create a damaged index, WDS prompts you to reinstall the product. When this occurs, we strongly recommend that you uninstall WDS before you reinstall it. Reinstalling WDS causes WDS to build new indexes. Rebuilding the indexes may take a long time, depending on how much information is indexed.

The WDS add-on for Internet Explorer appears as “dsWebAllowBHO” instead of as “Windows Desktop Search”

When you view add-ons in Internet Explorer, the WDS program appears as “dsWebAllowBHO” instead of as “Windows Desktop Search.”  “DsWebAllowBHO” is a Browser Helper Object that lets you perform a desktop search from a web search engine. For example, at the top of the http://www.msn.com website is a search box that has a list of search types above it. If you type a search term and then click Desktop above the search box, the search parameters are passed to WDS to process. When this add-on is disabled, WDS continues to work normally. However, you cannot perform a desktop search from a web page.

To view the list of add-ins in Internet Explorer, follow these steps:

On the Tools menu, click Internet Options.

On the Programs tab, click Manage Add-ons.

Office documents sent as attachments appear in text format

Office documents are indexed and searchable when they are received as attachments. However, by default, the attachments appear in a text-only format in the Preview Pane. To view these attachments in a rich preview format, follow these steps:

Right-click the WDS icon in the notification area.

Click Desktop Search Options.

In the tree menu, click Advanced.

In Advanced Options, enter the extensions that you want to preview in rich-preview format in the Preview Attachments section. Separate each extension with a semicolon.

WDS does not return results for words in foreign languages

When you use the English version of WDS with Windows 2000 to search for words that contain special characters or for words that are written by using a different character set, WDS may not return results. For example, this issue may occur when you search for words in Russian, Japanese, Arabic, or other languages.

This issue does not affect Windows 2000 with Service Pack 3 (SP3) or Windows XP with SP1. To work around this issue, make sure that computers that are running Windows 2000 have the latest service pack installed.

Additional information

Installing WDS using the “Run As” option is not supported

Using the “Run As” option to install WDS during download is not supported. When you use this option, parts of WDS may not run correctly. For example, if you right-click the WDS icon in the notification area, click Help, and then click Display Windows Deskbar, the deskbar may not appear. For best results, download WDS, and then install WDS by using an Administrator account or by using an automated service that runs with administrative credentials.

Smart Indexer

The Smart Indexer feature helps WDS enhance the user experience. Typically, the indexer runs when the system is idle. WDS monitors the system for any of the following situations:

User input, such as mouse or keyboard input.

System performance counters, such as CPU usage, and memory.

Low disk space.

By default, the indexer pauses in these situations. Additionally, on a computer that is running on battery power, only new items are indexed. Changed and deleted items are updated the next time that you connect the computer to AC power.

To temporarily disable this functionality, right-click the WDS icon in the notification area, and then click Index Now. This also temporarily stops the indexer from pausing. You can permanently disable this functionality by clicking Prioritize Indexing in the Advanced section of Desktop Search options.

Indexing a calendar on a SharePoint server or in Share Point Services

You can index a calendar on a SharePoint server. To do this, connect to the server, click the link to display the calendar, and then click Link to Outlook on the toolbar above the calendar. Outlook will ask if you want to add the folder to Outlook. If you click Yes, the calendar will appear in your folder tree as a subfolder of "SharePoint Folders." If you click No, these folders are not added to your Outlook profile.

To remove these folders from your profile, right-click SharePoint Folders, and then click Close "SharePoint Folders." You are warned that the links to the SharePoint Service data will be lost if you close the folders, and you are asked if you want to continue. If you click Yes, the "SharePoint Folders" folder and its subfolders are removed from your profile. Click No to cancel the operation and to leave the folders in your profile.

Uninstalling WDS

If you uninstall WDS on an individual computer, we recommend that you use the Add or Remove Programs Control Panel item. When you use Add or Remove Programs, make sure that you select the Show Updates option and uninstall the newest product or product updates first.

When you use Add or Remove Programs to remove WDS 02.06.0 or a later version of WDS, you may receive a warning message that includes a list of updates that are installed on your computer. This message also includes the following text:

“If Windows Desktop Search is removed, these programs may not run properly.  Do you wish to continue?”

This message occurs because WDS is installed as an update, and therefore appears with other Windows updates. You can ignore this message. Although some updates may not run correctly after another update is removed, none of the listed updates will be affected when you remove WDS.

If you use a script or a third-party product to uninstall WDS, we recommend that you use the uninstallation package (Spuinst.exe) for the most recent version. However, we strongly recommend that you use Add or Remove Programs in Control Panel to remove WDS instead of a script or a third-party product. Although WDS creates a system restore point when you install it, we do not recommend that you use the restore point to remove WDS.

To uninstall WDS, use the uninstaller package for your specific version. You can find the uninstaller package in one of the following locations:

VersionLocation

2.6.0.2083

%systemroot%\$NtUninstallKB907371-V2$\spuninst

2.6.0.2057

%systemroot%\$NtUninstallKB907371$\spuninst

Uninstall options

Interactive – Spuninst.exe runs without any command-line arguments. The uninstaller prompts you to restart your computer.

%systemroot%\$NtUninstallKB907371-V2$\spuninst\spuninst.exe

Quiet – Spuninst.exe runs by using the /q or /quiet command-line argument. The uninstaller restarts the system without informing the user.

systemroot%\$NtUninstallKB907371-V2$\spuninst\spuninst.exe /q

or

systemroot%\$NtUninstallKB907371-V2$\spuninst\spuninst.exe /quiet

Passive – Spuninst.exe runs by using the /passive command-line argument. The uninstaller prompts you to restart your computer, and displays the remaining time in seconds until it restarts your computer automatically.

%systemroot%\$NtUninstallKB907371-V2$\spuninst\spuninst.exe /passive

To see other command-line options, run the spuninst.exe /help command at a command prompt.

Uninstalling versions 2.5.0.1082 and 2.5.0.1119

Version 02.06.X will not install correctly on a computer that is running version 02.05.0.1082 or an earlier version of WDS. Before you install the newer version, you must first uninstall the earlier version of WDS.

Use the Msiexec.exe program to uninstall WDS. We recommend that you use one of the following methods.

Method 1: Use the product code

To find the product code in the registry, click Start, click Run, type regedit in the Open box, and then click OK. In Registry Editor, locate the following registry subkey:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSN Apps\MSN Toolbar Suite

The product code is the value of the PC registry entry. For example, when version 2.5.0.1082 of WDS is installed, the value of the PC registry entry is "7d1dcbba-f6f5-42b4-b90b-f04ace4dfd6c."

Run a command that is similar to the following, including the product code in brackets. When you are uninstalling version 02.05.0.1082 of WDS, use the following command line. Note The brackets { } are required.

Msiexec.exe /x {7d1dcbba-f6f5-42b4-b90b-f04ace4dfd6c} /qn

The /x switch causes Msiexec to uninstall the product, and the /qn switch disables alerts during the uninstall process. For more information about Msiexec.exe command-line options, type msiexec /? at a command prompt.

Method 2: Use the MSN Search Toolbar Windows Installer

The MSN Search Toolbar Windows Installer is located in the following location, where <Version Number> is the version of the product being uninstalled, such as 02.05.0000.1082, and <Drive> is the letter of the disk drive where Windows is installed.

<Drive>:\Documentsand Settings\All Users\Application Data\MSN Search Toolbar\<Version Number>\en-us

Run the following command to uninstall WDS:

msiexec.exe /x "<Drive>:\Documents and Settings\All Users\Application Data\MSN Search Toolbar\<Version Number>\en-us\MsnSearchToolbar.msi" /qn

We recommend that you use Method 1. When you use Method 1, the only required variable is the product code that is stored in the registry. When you use Method 2, you must provide the letter of the disk drive where Windows is installed and the version number of WDS.

Understanding the “Windows Desktop Search Indexing Status” Dialog

Two counters are listed in the Windows Desktop Search Indexing Status dialog box: Items indexed so far and Items left to scan.

The Items left to scan counter records the number of items that are currently queued to be scanned for updates or changes. Typically, the indexer keeps a list of folders that it has to index. The indexer starts by finding out whether anything in a folder has changed. If it doesn’t detect any changes, the indexer skips the folder and goes to the next folder. If the indexer detects changes in the next folder, it searches all the items and subfolders in that folder to determine the changes. As the indexer searches deeper in the folder path and finds new folders to search, the number in Items left to scan increases or decreases.

Additional resources

Windows license information

System Requirements

Toolbar corporate website

Update.exe command-line options

Information about Group Policy on Microsoft TechNet

Group Policy template file

WDS developers guide

WDS Add-ins

FAQ for Windows Desktop Search

Document revision history

DateChanges made

26 Jan 2006

Updated WDS installation package to WindowsDesktopSearch-KB907371-V2-x86-XXX.exe. Added release date version table.

8 Mar 2006

New revision. Added additional sections and this revision table.


 

© 2006 Microsoft Corporation. All rights reserved. Terms of Use |Trademarks |Privacy Statement
Microsoft