ControlPoint 8.7 - User Guide

Running ControlPoint Discovery Interactively from the ControlPoint Application

ControlPoint Application Administrators can run the Discovery Service interactively from the ControlPoint application interface between scheduled Discovery runs.

NOTE:  For Discovery to be run interactively, the Discovery Service must be installed, configured, and running.  Refer to the ControlPoint Administration Guide for details.

To run a ControlPoint Discovery interactively:

1From the Manage ControlPoint panel choose ControlPoint Management > Discovery.

NOTE:  If you are not a ControlPoint Application Administrator, this option will be hidden.

2Click [Run Now].

The results show each table in the ControlPoint Services (xcadmin) database that the Discovery Service collects data from.  The Auto Refresh Setting will refresh results every 3 seconds by default, but that value can be changed.

NOTE:  The Queue Date is the date and time of the next scheduled Discovery.

Searching for SharePoint Sites

The ControlPoint search functionality is designed to complement that used by SharePoint.  

The SharePoint search focuses on content (documents, users, and so on) based on metadata and/or words within the content.  The ControlPoint search focuses on finding SharePoint sites based on their properties.

ControlPoint lets you:

·locate SharePoint sites by entering simple search terms or using an Advanced Search, and

·find a SharePoint site within the context of the ControlPoint SharePoint Hierarchy using the Search Hierarchy function.

A search can also be used to locate objects in the Change Selection pane and the various object pickers used throughout ControlPoint.

TIP:  For locating sites within a very large farm, consider using the ControlPoint search functionality as a time-saving alternative to browsing through the SharePoint Hierarchy.

Performing a Simple or Advanced Search

To locate sites within your SharePoint environment, you can perform either:

·a simple search (by entering a full or partial site name or url), or

·an advanced search (by selecting from a variety of criteria on which to base your search).

NOTE:  Simple and advanced searches use cached data collected by the ControlPoint Discovery job.  This means that it will take less time to process then a hierarchy search, which by default uses real-time data.  

To perform a simple search:

1From the left navigation frame choose Search.

2Enter a full or partial site name in the Simple Search Terms box.

3Click the magnifying glass icon ().

NOTE:  Results will include sites that match any part of the text string that you entered.

To perform an advanced search:

1Use one of the following options:

§From the SharePoint Hierarchy or Search Hierarchy results, select the object(s) on which you want to perform your search.  Right-click and choose Advanced Search.

§From the left navigation frame Search tab, choose Advanced Search.

NOTE:  When you initiate your search from anywhere within the SharePoint Hierarchy, the scope of the search will be limited to sites within that level of the hierarchy.  When you initiate the search from the Search tab, the search will include all matching sites within the farm.  The Central Administration site, however, is always excluded from search results.

2In the Parameters section, select/enter the criteria you want to use to narrow your search.

You can:

§enter a full or partial Site Name and/or Site URL

NOTE:  If you enter a Site URL, only the URLs of sites within the SharePoint farm for which you have management permissions will be included in the search.  Links from a page in the farm to other sites in the farm or content outside the farm will not be searched. In addition, unlike the simple search, if you enter more than one word in the name field, the full string as you typed it must occur within a site name for it to display in the results.

§select one or more site attributes:

§Site Template Used or Not Used

§Web Parts Used or Not Used

§System Master Page Used or Not Used, and/or

§Site Theme  Used or Not Used.

NOTE:  Because the search uses cached data, the drop-down lists for the above attributes are populated with items that are current as of the last time ControlPoint Discovery was run and contain values that have actually been used within the selected scope.

§specify one or more site parameters, by selecting the appropriate operator (>=, <=, or =) and entering a value for:

§number of Files

§Size (KB)

§Quota

§% of Quota

§Created date, and/or

§Last Modified date.

NOTE:  If you enter a Quota <= a specified value, sites for which a quota has not been set will also be included in results.

§select a Security level that is currently in use in the site's "has permissions" field.

§select whether you want to find sites which have permissions that are either Inherited or Unique.

§find sites for which a specific user has permissions; by selecting a user.

You can, optionally, further narrow your search by locating only those sites for which the user or group has permissions at a specific level.

If you have a SharePoint Server farm and the ControlPoint Application Administrator has defined Custom Properties, you can locate sites that have been assigned specific Custom Properties via the Set Site Properties action. (This section does not display for SharePoint  Foundation farms.)

NOTE:  The search will return only those sites that meet all of the criteria you specify, including Not Used criteria. For example if you are searching for sites that do not use the Team Site template and do not use the Cardinal theme, only sites which use neither will be included in results.

All of the sites that meet the criteria you specified display in the Search Results.

If you want to initiate a new search or change search criteria, first click [Reset] to clear the contents of the Advanced Search window.

Working with Simple or Advanced Search Results

All simple and advanced search results pages include a standard header and footer, in addition to search results detail.

Search Results Toolbar

ControlPoint search results pages employ a report toolbar that contains page navigation, zoom, find, export, and print capabilities.

Search Results Header

The search results header sections contains summary information, including the search criteria used, as well as the scope of the search (as determined by the level at which the search was initiated).

The Cached field displays the date and time that the cache was last refreshed via ControlPoint Discovery.  The search results are current as of that date and time.

Search Results Footer Information

The search footer contains the following information:

·the name of the administrator who generated the search (which can be useful if search results are exported or printed and distributed, since the content of the search reflects that administrator's permissions)

·the number of pages in the search (you can scroll through multi-page search results from the results toolbar in the search results header), and

·the date and time when the search results were generated.

Acting on Search Results

From search results you can perform any of the actions described in the following table.