Get-FASTSearchSecurityCacheState

 

Applies to: SharePoint Server 2010

Gets information about, or controls the caching of user security search filters..

Syntax

Get-FASTSearchSecurityCacheState [-Action] <String> [[-Identity] <String>] [[-User] <String>] [[-Worker] <WorkerPoolNode>]

Detailed Description

This cmdlet displays information about the caching of user search security filters and controls the caching of the filters. The cmdlet's results depend on the value of the Action parameter:

-- GetCount - Counts the number of user search security filters in the cache.

-- IsUserCached - Returns true if the search security filter cache contains a filter for the user.

-- RemoveUserCache - Removes a user's search security filter from the cache.

-- ClearCache - Removes all filters from the security search filter cache.

Parameters

Parameter Required Type Description

Action

Required

System.String

The Action parameter determines the type of task to perform. Valid values and actions include:

-- GetCount - Counts the number of user search security filters in the cache.

-- IsUserCached - Returns true if the search security filter cache contains a filter for the user.

-- RemoveUserCache - Removes a user's search security filter from the cache.

-- ClearCache - Removes all filters from the security search filter cache.

Identity

Optional

System.String

When the Action parameter is set to IsUserCached or RemoveUsercache, this parameter is used to identify the user store that contains the user.

User

Optional

System.String

When the Action parameter is set to IsUserCached or RemoveUsercache, this parameter identifies the user associated with the cached search filter.

Worker

Optional

Microsoft.SharePoint.Search.Extended.Security.PowerShell.Commands.Troubleshooting.WorkerPoolNode

The optional Worker parameter specifies the WorkerPoolNode object for the security worker that is to handle the request.

Input Types

Return Types

Example

---------------EXAMPLE 1-----------------

Get-FASTSearchSecurityCacheState  -action GetCount

This example gets the count of user search filters in the security cache.

---------------EXAMPLE 2-----------------

Get-FASTSearchSecurityWorkerNode workerserver | Get-FASTSearchSecurityCacheState -action IsUserCached -SecurityContentId tst -User usera

This example returns true if the search security filter for “usera” is cached, and false if the user's search filter is not cached. The request is handled by the worker with the server name “workerserver”, specified by the piped in WorkerPoolNode parameter.