New-FASTSearchSecurityRegexAliaserPattern

Article
07/25/2014

Applies to: SharePoint Server 2010

Creates a new regular expression pattern for a regex principal aliaser.

Syntax

New-FASTSearchSecurityRegexAliaserPattern [-Regex] <String> [-MapToUsername] <String> [[-InputPropertyName] <String>] [-Patterns <List>]

Detailed Description

This cmdlet creates a new regular expression pattern that can be added to the list of patterns for a regular expression based principal aliaser. This cmdlet creates a regular expression pattern that is used by and input to the New-FASTSearchSecurityRegexAliaser and Set-FASTSearchSecurityRegexAliaser cmdlets.

Parameters

Parameter	Required	Type	Description
Regex	Required	System.String	The regular expression pattern that determines if the user or group should be mapped to another user store. This regular expression pattern may contain regular expression groups that may be used in the generation of the MapToUsername value.
MapToUsername	Required	System.String	The user or group name to look to. This can also contain regular expression group replacements using the syntax: `\#` where `#` is the group capture index.
InputPropertyName	Optional	System.String	The user/group property name this regular expression pattern is matched against. The InputPropertyName is one of the following: -- $PRINCIPAL_REFERENCE_ID - The identifier of the user or group. This is the default. -- $PRINCIPAL_REFERENCE_ALIAS - The alias of the user or group. Any other property of the user or group. Refer to your specific user store for other properties that the user store exposes.
Patterns	Optional	System.Collections.Generic.List	A list of RegExAliasPatternMapConfig objects. The RegExAliasPatternMapConfig being created is added to this list.

Input Types

Return Types

Example

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

New-FASTSearchSecurityRegexAliaserPattern -Regex .* -InputPropertyName mail -MapToUsername "\1"

This example creates a regular expression pattern that can be used to map the “mail” property of a Microsoft user store to identities in other user stores.

Use the regex pattern configuration object output from this command for the value of a pattern's parameter in a New-FASTSearchSecurityRegexAliaser or a Set-FASTSearchSecurityRegexAliaser cmdlet.