Edit

Share via


Set-FASTSearchSecurityXMLAliaser

Updates an XML aliaser.

Syntax

Default (Default)

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

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.

For permissions and the most current information about FAST Search Server 2010 for SharePoint cmdlets, see the online documentation, (https://go.microsoft.com/fwlink/?LinkId=163227).

Examples

EXAMPLE 1 (FAST Server for SharePoint 2010)

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

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

EXAMPLE 2 (FAST Server for SharePoint 2010)

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.

Parameters

-Identity

Applicable: FAST Server for SharePoint 2010

The identity of the XML aliaser to update.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-InputPropertyName

Applicable: FAST Server for SharePoint 2010

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputUserStoreId

Applicable: FAST Server for SharePoint 2010

The identity of the mapped-from user store.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OutputUserStoreIds

Applicable: FAST Server for SharePoint 2010

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

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PathToXMLFile

Applicable: FAST Server for SharePoint 2010

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-XMLAliaser

Applicable: FAST Server for SharePoint 2010

A SecurityXMLAliaserobject whose property values are being updated.

Parameter properties

Type:SecurityXMLAliaser
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.