Remove-FASTSearchMetadataManagedProperty

Article
07/25/2014

Applies to: SharePoint Server 2010

Removes a managed property from the Microsoft FAST Search Server 2010 for SharePoint system.

Syntax

Remove-FASTSearchMetadataManagedProperty -ManagedProperty <ManagedProperty> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Remove-FASTSearchMetadataManagedProperty [-Name] <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detailed Description

This command removes a managed property and its content from the FAST Search Server 2010 for SharePoint system. If the managed property is mapped into any full text indexes, the mapping is also removed. If there are any crawled property mappings to this managed property, those mappings are also removed.

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set, and you may not combine parameters from different parameter sets. When doing simple operations, there is no difference between using the ManagedProperty versus the Name parameter. The only difference is when using the Name parameter you look up the managed property each time, while when using the ManagedProperty parameter you use the object you already have a reference to. However, when dealing with operations involving a large set of objects (for example iterating over all categories), avoiding extra lookups by name can be slightly more efficient. For more information about how to use parameter sets, see Cmdlet Parameter Sets.

Parameters

Parameter	Required	Type	Description
Name	Required	System.String	The name of the managed property to remove.
ManagedProperty	Required	Microsoft.SharePoint.Search.Extended.Administration.Schema.ManagedProperty	An object that represents the managed property to remove.
Confirm	Optional	System.Management.Automation.SwitchParameter	Activates user prompting to confirm the operation. If set, prompting is activated. If Confirm is false (`-Confirm:$false`), confirmation prompting is not used. In cases where Confirm is not specified, the cmdlet will prompt if the `$ConfirmPreference` shell variable is equal to or greater than the ConfirmImpact setting of the cmdlet (HIGH).
Force	Optional	System.Management.Automation.SwitchParameter	Overrides any user prompting settings, so that confirmation of the operation is not required.
WhatIf	Optional	System.Management.Automation.SwitchParameter	Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Input Types

Return Types

Example

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

Remove-FASTSearchMetadataManagedProperty -Name title

This example removes the managed property named “title” from the system. It will ask for confirmation before going through with the removal unless Force is specified.

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

$createdby = Get-FASTSearchMetadataManagedProperty -name CreatedBy
Remove-FASTSearchMetadataManagedProperty -ManagedProperty $createdby -Force

This example removes the managed property represented by the object $managedproperty. The object is retrieved by calling Get-FASTSearchMetaDataManagedProperty, but any other call that returns a ManagedPropertyImpl object is acceptable.

No confirmation is required, since the Force parameter is specified.