Set-FASTSearchSecurityXMLAliaser

  • Article

 

Applies to: SharePoint Server 2010

Updates an XML aliaser.

Syntax

Set-FASTSearchSecurityXMLAliaser -Identity <String> [-InputPropertyName <String>] [-InputUserStoreId <String>] [-OutputUserStoreIds <String[]>] [-PathToXMLFile <String>] [-XMLAliaser <SecurityXMLAliaser>]

Detailed Description

This cmdlet updates the configuration settings for an XML principal aliaser.

An XML aliaser maps users/groups from one user store to users/groups in other user stores, based on an XML mapping file.

Parameters

Parameter Required Type Description

Identity

Required

System.String

The identity of the XML aliaser to update.

InputPropertyName

Optional

System.String

The user/group property name this regular expression pattern is matched again.

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.

InputUserStoreId

Optional

System.String

The identity of the mapped-from user store.

OutputUserStoreIds

Optional

System.String[]

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

PathToXMLFile

Optional

System.String

The absolute path to the XML mapping file to upload to the XML aliaser.

The path must specify a file accessible to the security manager.

XMLAliaser

Optional

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

A SecurityXMLAliaserobject whose property values are being updated.

Input Types

Return Types

Example

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

Set-FASTSearchSecurityXMLAliaser -Identity xmlalias1 -PathToXMLFile "C:\dev\temp\mapping1.xml"

This example uploads and updates the XML mapping for an XML aliaser.

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

Get-FASTSearchSecurityAliaser myxmlalias | Set-FASTSearchSecurityXMLAliaser -OutputUserStoreIds ln2 -InputPropertyName '$PRINCIPAL_REFERENCE_ALIAS'

This example changes the OutputUserStoreIds and InputPropertyName for the XML aliaser piped from a Get-FASTSearchSecurityAliaser cmdlet.

See Also

Reference

New-FASTSearchSecurityXMLAliaser
Get-FASTSearchSecurityXMLAliaser