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.