New-FASTSearchSecurityXMLAliaser

 

Applies to: SharePoint Server 2010

Creates an XML principal aliaser.

Syntax

New-FASTSearchSecurityXMLAliaser [-InputUserStoreId] <String> [-OutputUserStoreIds] <String[]> [[-Identity] <String>] [[-InputPropertyName] <String>] [-ObjectToClone <SecurityXMLAliaser>]

Detailed Description

This cmdlet creates an XML aliaser to map users and groups from one user store to users and groups in other user stores, based on an XML mapping file.

Parameters

Parameter Required Type Description

InputUserStoreId

Required

System.String

The identity of the mapped-from user store.

OutputUserStoreIds

Required

System.String[]

A comma-separated list of mapped-to user store identities.

Identity

Optional

System.String

The identity of the aliaser. An identity is generated if the parameter is not specified.

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.

Be sure to enclose in single quotes: '$PRINCIPAL_REFERENCE_ID'

-- $PRINCIPAL_REFERENCE_ALIAS - The alias of the user or group.

Be sure to enclose in single quotes: '$PRINCIPAL_REFERENCE_NAME'

Any other property of the user or group. Refer to your specific user store for other properties that the user store exposes.

ObjectToClone

Optional

Microsoft.SharePoint.Search.Extended.Security.PowerShell.Commands.XmlAliaser.SecurityXMLAliaser

A SecurityXMLAliaserobject whose property values are copied as a baseline in the creation of another SecurityXMLAliaser aliaser.

Input Types

Return Types

Example

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

New-FASTSearchSecurityXMLAliaser -InputUserStoreId win -OutputUserStoreIds ln3 -InputPropertyName mail

This example creates an XML principal aliaser to map the mail property of a Microsoft user store to users and groups in another user store.

Use the Set-FASTSearchSecurityXMLAliaser cmdlet to upload the XML mapping file.

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

Get-FASTSearchSecurityAliaser xmlalias2 | New-FASTSearchSecurityXMLAliaser -Identity myxmlalias -OutputUserStoreIds ln2

This example creates an XML principal aliaser based on an existing XML aliaser but sets the output user store IDs to 'ln2'.

Use the Set-FASTSearchSecurityXMLAliaser cmdlet to upload an XML mapping file with desired mappings for the new aliaser.

See Also

Reference

Set-FASTSearchSecurityXMLAliaser
Get-FASTSearchSecurityXMLAliaser