Register-AdfsAuthenticationProvider

Registers an external authentication provider in AD FS.

Syntax

Default (Default)

Register-AdfsAuthenticationProvider
    -TypeName <String>
    -Name <String>
    [-ConfigurationFilePath <String>]
    [<CommonParameters>]

Description

The Register-AdfsAuthenticationProvider cmdlet registers an external authentication provider as a provider in Active Directory Federation Services (AD FS). Use the Get-AdfsAuthenticationProvider cmdlet to get a list of registered authentication providers.

Examples

Example 1: Register an authentication provider

PS C:\> $TypeName = "ExternalAuthMethod.ExternalAuthProvider, ExternalAuthProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=365143bb27e7ac8b, processorArchitecture=MSIL"
PS C:\> Register-AdfsAuthenticationProvider -TypeName $TypeName -Name "MyExternalAuthProvider" -ConfigurationFilePath ".\configdata.txt"

The first command creates a variable named $TypeName that contains the configuration data for an external provider.

The second command registers the authentication provider by using the data stored in the $TypeName variable.

Parameters

-ConfigurationFilePath

Specifies the fully qualified file path of a file that contains authentication provider configuration data.

You can also upload the file to the Active Directory Federation Services (AD FS) configuration store and make it available to the authentication provider. Use this method if you want to provide additional information that pertains to a specific customer when you initialize the authentication provider. Any usage of this method is specific to the vendor that supplies the authentication provider.

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

-Name

Specifies the name of an authentication provider to register in AD FS.

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:False
Value from remaining arguments:False

-TypeName

Specifies the fully qualified type of the authentication provider assembly on the federation server.

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: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.

Outputs

Object