Bereikregels beheren

Met Verkenningsbereikbeheer (CSM) kunt u bereikregels definiëren die URL's opnemen of uitsluiten van het verkenningsbereik van Windows Search.

Met de CSM kunt u het volgende doen:

  • Nieuwe bereikregels toevoegen aan de werkregelset
  • Bestaande bereikregels verwijderen
  • De standaardbereikregels opsommen
  • Ontdek of een specifieke URL is opgenomen in of uitgesloten van het verkenningsbereik, of dat deze een bovenliggende of onderliggende bereikregel heeft.

 

Dit onderwerp bevat de volgende onderwerpen:

Informatie over bereikregels

Een bereikregel is een regel die URL's binnen een zoekroot omvat of uitsluit van crawlen en indexeren. Insluitingsregels zorgen ervoor dat de indexeerfunctie die URL in het scrawl-bereik opneemt en uitsluitingsregels ervoor zorgen dat de indexeerfunctie die URL (en de onderliggende elementen) van het verkenningsbereik uitsluit.

Stel dat u een nieuwe toepassing hebt geïnstalleerd waarvan de gegevensbestanden zich bevinden in de map WorkteamA\ProjectFiles op een lokale computer. Stel dat u wilt dat alles in de map ProjectFiles is geïndexeerd, met uitzondering van items in de submap Prototypes. In deze situatie hebt u een insluitingsregel nodig voor myPH:///C:\WorkteamA\ProjectFiles\ en een uitsluitingsregel voor myPH:///C:\WorkteamA\ProjectFiles\Prototypes\.

Er zijn drie soorten regels, met de volgende prioriteitsvolgorde:

  1. Groepsbeleidsregels worden ingesteld door beheerders en kunnen alle andere regels overschrijven.
  2. Gebruikersregels worden ingesteld door gebruikers die het bereik wijzigen in de gebruikersinterface van Windows Search-opties. Gebruikers of andere toepassingen kunnen alle gebruikersregels verwijderen en terugkeren naar standaardregels.
  3. Standaardregels worden doorgaans ingesteld door een toepassing om een standaardbereik te definiëren. Standaardregels kunnen bijvoorbeeld worden ingesteld wanneer een nieuwe protocolhandler of container wordt toegevoegd aan het systeem.

Samen vormen deze typen regels de werkregelset waaruit de CSM (Crawl Scope Manager) de volledige lijst met URL's genereert die moeten worden verkend. Hoewel standaardregels kunnen worden overschreven door groepsbeleidsregels en gebruikersregels, worden ze onderhouden in hun eigen standaardregelset, waarnaar u op elk gewenst moment kunt terugkeren. De indexeerfunctie verkent de URL's uit de werkregelset en voegt items, eigenschappen en inhoud toe aan de catalogus.

Notitie

Gebruikers met toegang tot het Configuratiescherm kunnen de regels via die interface wijzigen. Daarom moeten toepassingen die bereikbeheer bieden, altijd de regels rechtstreeks van de CSM ophalen met behulp van de opsommingsmethoden in plaats van te vertrouwen op een opgeslagen kopie van gebruikersregels.

 

Uitsluitingsregels kunnen patroon-URL's definiëren met het jokerteken '*'; bijvoorbeeld: file:///C:\ProjectA\*\. Een uitsluitingsregel die dit patroon gebruikt, voorkomt dat de indexeerfunctie mappen onder de ProjectA-map verkent. Stel dat er een insluitingsregel is voor file:///C:\ProjectA\ en een uitsluitingspatroonregel voor file:///C:\ProjectA\*\data\*. In dit geval zou de indexeerfunctie items verkennen in:

  • C:\ProjectA\
  • C:\ProjectA\version1\testfiles\
  • C:\ProjectA\version1\temp\data\

Maar de indexeerfunctie zou geen items verkennen in:

  • C:\ProjectA\versie 1\data\

 

Voordat u begint

Voordat u een van de Crawl Scope Manager-interfaces gebruikt, moet u de volgende vereiste stappen uitvoeren:

  1. Maak het CSearchManager--object en haal de ISearchManager interface op.
  2. Roep ISearchManager::GetCatalog aan voor 'SystemIndex' om een exemplaar van de ISearchCatalogManager interface te verkrijgen.
  3. Roep ISearchCatalogManager::GetCrawlScopeManager aan om een exemplaar van de ISearchCrawlScopeManager interface te verkrijgen.

Nadat u wijzigingen hebt aangebracht in verkenningsbereikbeheer, moet u de methode ISearchCrawlScopeManager::SaveAll aanroepen. Deze methode heeft geen parameters en retourneert S_OK bij succes.

 

Bereikregels toevoegen

De werkregels die zijn ingesteld voor de CSM, bevatten gebruikers- en standaardregels, evenals regels die worden afgedwongen door groepsbeleid. Gebruikersregels worden ingesteld door gebruikers in een gebruikersinterface en standaardregels kunnen op een van de volgende manieren worden ingesteld:

  • Groepsbeleid dat is geïmplementeerd door een systeembeheerder (deze maken geen gebruik van de ISearchCrawlScopeManager interface.)
  • De installatie of update van een toepassing zoals Windows Search of een protocolhandler
  • Een installatietoepassing voor het toevoegen van een nieuw gegevensarchief of een nieuwe container

De ISearchCrawlScopeManager biedt twee methoden voor het toevoegen van nieuwe bereikregels, zoals beschreven in de volgende tabel. Paden voor insluitingsregels voor het bestandssysteem moeten eindigen met een backslash '\' (bijvoorbeeld file:///C:\files\) en paden voor uitsluitingsregels moeten eindigen met een sterretje (bijvoorbeeld file:///c:\files\*). Alleen uitsluitingsregels kunnen patroon-URL's bevatten. Bovendien raden we aan om de beveiligings-ID's (SID's) van gebruikers op te nemen in paden, voor betere beveiliging. Paden per gebruiker zijn veiliger omdat query's vervolgens worden uitgevoerd in een proces per gebruiker, zodat de ene gebruiker bijvoorbeeld geen items kan zien die zijn geïndexeerd vanuit het Postvak IN van een andere gebruiker.

In de volgende tabel worden de methoden beschreven van de ISearchCrawlScopeManager-interface die wordt gebruikt voor het toevoegen van nieuwe bereikregels.

Methode Beschrijving
AddUserScopeRule Hiermee voegt u een regel voor een URL toe, zoals opgegeven door de gebruiker. Deze regels overschrijven standaardregels. Gebruik deze methode als u een gebruikersinterface hebt geïmplementeerd waarmee gebruikers hun eigen bereikregels en URL's kunnen beheren.
AddDefaultScopeRule Hiermee voegt u een regel voor een URL toe, zoals opgegeven door een andere toepassing, zoals een protocolhandler. Gebruik deze methode wanneer u een nieuwe protocolhandler hebt geïmplementeerd of een nieuw gegevensarchief hebt toegevoegd. Deze regels kunnen worden overschreven door gebruikersregels.

 

Elke methode gebruikt een URL naar een indexeerbare locatie en vlaggen die bepalen of de URL moet worden opgenomen of uitgesloten. De parameter fFollowFlags is gereserveerd voor toekomstig gebruik. Wanneer u een nieuwe bereikregel toevoegt en verkenningsbereikbeheer bepaalt dat de regel al bestaat (op basis van de URL of het opgegeven patroon), wordt de werkregelset bijgewerkt, zodat (1) de oude regel wordt vervangen door de nieuwe regel en (2) alle gebruikersregels die in strijd zijn met deze regel worden verwijderd.

Tip: Hoewel de root van de file:// standaard is opgenomen in het doorzoeksbereik, worden Program Files niet standaard geïndexeerd. Daarom moeten toepassingen met gegevens die zijn opgeslagen in de map Program Files hun locatie toevoegen als standaardregel.

Notities over gebruikersregels

Als een nieuwe gebruikersregel hetzelfde is als een bestaande standaardregel, overschrijft de nieuwe gebruikersregel de standaardregel in de werkregelset. Als de nieuwe gebruikersregel hetzelfde is als een bestaande gebruikersregel, wordt de oude gebruikersregel vervangen.

Het instellen van de vlag fOverrideChildren heeft de volgende resultaten in de werkregelset:

  • TRUE resulteert in het verwijderen van alle subregels uit de actieve regelset (zowel gebruikersregels als standaardregels).
  • False resulteert in het opnieuw toevoegen aan de werkregelsset van alle standaardregels die onderliggende elementen zijn van de nieuwe gebruikersregel. Als een subregel een insluiting is en de nieuwe gebruikersregel een uitsluiting is, wordt de regel omgezet in een insluitingsregel voor gebruikers.

 

Bereikregels verwijderen

U kunt de ISearchCrawlScopeManager interface gebruiken om een bereikregel uit de werkregelset te verwijderen. Deze interface biedt de volgende twee methoden voor het verwijderen van bereikregels.

Methode Beschrijving
RemoveScopeRule Hiermee verwijdert u een gebruikersregel voor een opgegeven URL uit de werkregelset. Als de gebruikersregel een duplicaat is van of een standaardregel overschrijft, blijft de standaardregel in de werkregelset staan.
RemoveDefaultScopeRule Hiermee verwijdert u een standaardregel voor een opgegeven URL uit zowel de werkregelset als de standaardregelset. Nadat u deze methode hebt aangeroepen, kunt u deze standaardregel niet herstellen met Behulp van RevertToDefaultScopes.

 

Elke methode gebruikt een URL en een vlag die aangeeft of de regel die moet worden verwijderd een insluitings- of uitsluitingsregel is. Deze methoden retourneren een fout als er geen regel met die URL en insluitings-/uitsluitingsvlag wordt gevonden.

Tip: Als u een bereik volledig uit het verkenningsbereik wilt verwijderen, gebruikt u de methode RemoveRoot, waarmee de zoekhoofdmap en alle bijbehorende bereikregels worden verwijderd. Dit tijdens het verwijderen doen wordt beschouwd als best practice.

Het is ook mogelijk om alle door de gebruiker ingestelde overschrijvingen van een zoekbasis te verwijderen en terug te keren naar de oorspronkelijke zoekbasis- en standaardbereikregels. Raadpleeg de volgende sectie voor meer informatie.

Notitie

Als gebruikers op Windows Vista worden verwijderd via gebruikersprofielen in het Configuratiescherm, verwijdert CSM alle regels en wortels die hun SID bevatten en verwijdert hun geïndexeerde items uit de catalogus. Op Windows XP moet u handmatig de gebruikers' rootcertificaten en configuratieregels verwijderen.

 

 

Standaardregels herstellen

Wanneer u terugkeert naar standaardregels, worden alle gebruikersregels voor een URL of root verwijderd en worden alle standaardregels hersteld in de werkregelset. Het verwijdert echter geen regels die zijn ingesteld door groepsbeleid. De methode RevertToDefaultScopes gebruikt geen parameters en retourneert een foutcode als deze niet kan terugkeren naar standaardregels.

 

Bereikregels inventariseren

De CSM somt bereikregels op door middel van een standaard COM-stijl enumeratorinterface, IEnumSearchScopeRules . U kunt deze interface gebruiken om bereikregels op te sommen voor verschillende doeleinden. U kunt bijvoorbeeld de volledige set werkende regels weergeven in een gebruikersinterface of ontdekken of een regel of een subregel al binnen de crawlscope valt.

 

Bereikregels voor tracering

Met de CSM kunt u ook bepalen of een opgegeven URL is opgenomen in het verkenningsbereik en of deze een bovenliggende of onderliggende bereikregel heeft. U kunt ook achterhalen waarom een URL is opgenomen of uitgesloten van het verkenningsbereik. Deze methoden zijn niet bedoeld voor gebruik met patroon-URL's.

In de volgende tabel worden de methoden van ISearchCrawlScopeManager gebruikt voor het toevoegen van nieuwe bereikregels.

Methode Beschrijving
GetParentScopeVersionId Haalt de versie-id van de bovenliggende insluitings-URL op. U kunt deze methode gebruiken om te zien of het bovenliggende bereik is gewijzigd sinds de laatste keer dat u het hebt gecontroleerd.
Voorbeeld: Als een e-mailtoepassing gebruikmaakt van door de provider beheerde meldingen, wordt mogelijk de bovenliggende bereikversie opgehaald voordat deze wordt gesloten en controleert u de versie opnieuw wanneer deze wordt geopend. Vervolgens kan de toepassing bepalen of deze een nieuwe set meldingen naar de indexeerfunctie moet pushen.
HasChildScopeRule Retourneert TRUE als de opgegeven URL een kindregel heeft (een regel die op een kindniveau binnen de URL-hiërarchie wordt toegepast).
Voorbeeld: Als de URL is file:///C:\Folder\, retourneert deze methode TRUE als de CSM een bereikregel heeft die specifiek is bedoeld voor file:///C:\Folder\Submap\.
HasParentScopeRule Retourneert TRUE als de opgegeven URL een ouderregel heeft (een regel die wordt toegepast op een ouderniveau in de URL-hiërarchie).
Voorbeeld: Als de URL file:///C:\Folder\Subfolder is, geeft deze methode TRUE terug als de CSM specifiek een bereikregel heeft voor file:///C:\Folder\.
IncludedInCrawlScope Retourneert TRUE- als de opgegeven URL is opgenomen in het verkenningsbereik.
IncludedInCrawlScopeEx Retourneert een waarde uit de CLUSION_REASON opsomming waarin wordt uitgelegd waarom de URL is opgenomen in of uitgesloten van het verkenningsbereik en haalt de waarde op TRUE als de URL is opgenomen in het verkenningsbereik. Met deze methode kunt u conflicten in uw werkregelset identificeren.

 

 

Notitie

De IncludedInCrawlScope en IncludedInCrawlScopeEx methoden bepalen of de URL alleen wordt verkend op basis van de regels in de CSM. Er kunnen andere redenen zijn waarom een URL niet wordt verkend, zoals de FANCI-bit die wordt ingesteld (een gebruiker heeft geen snelle indexering toegestaan in het dialoogvenster Eigenschap van de map.)

 

Als u denkt dat een bestandspad moet worden uitgesloten, maar het wordt vermeld als opgenomen, moet u ervoor zorgen dat uitsluitingsregels eindigen op '<pad>\*'. Als u van mening bent dat een bestand of bestandspad moet worden opgenomen maar dat niet is, zorg er dan voor dat u de instelling van de FANCI-bit voor het bestand of pad controleert. U kunt dit doen door met de rechtermuisknop op het bestand of bestandspad te klikken en Eigenschappente selecteren. Zorg er vervolgens voor dat het selectievakje Voor snel zoeken toestaan dat Indexing Service deze map indexeert selectievakje is ingeschakeld. Als het bestand of bestandspad hier niet is gemarkeerd voor indexering, wordt het niet geïndexeerd, zelfs niet als het zich in een insluitingsregel bevindt.

Verwijzing

ISearchCrawlScopeManager

ISearchCrawlScopeManager2

ISearchScopeRule

IEnumSearchScopeRules

Conceptuele

Search Roots beheren

 

 

  • Laatst bijgewerkt om