Add-AXSharepointClaimsAuthenticationProvider

Article
03/15/2012

Add-AXSharepointClaimsAuthenticationProvider

Adds a claims-based authentication provider to a Microsoft SharePoint Server installation and creates a web application associated with the provider.

Syntax

Parameter Set: Default
Add-AXSharepointClaimsAuthenticationProvider [-ClearTextPassword <String> ] [-ConnectionString <String> ] [-Credential <PSCredential> ] [-Name <String> ] [-Port <Int32> ] [-ProviderAssemblyName <String> ] [-ProviderTypeName <String> ] [-ServerUrl <String> ] [-SigningCertificate <X509Certificate2> ] [-SSLCertificate <X509Certificate2> ] [-Type <String> ] [-UserName <String> ] [ <CommonParameters>]

Detailed description

The Add-AXSharepointClaimsAuthenticationProvider adds a claims-based authentication provider to a SharePoint Server installation and creates a web application associated with it.

Parameters

-ClearTextPassword<String>

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ConnectionString<String>

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Credential<PSCredential>

Specifies the credentials of the administrator for the SharePoint Server web application that will be created for the trusted identity provider. This parameter is required when Type is Forms or Live.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Name<String>

Specifies the name that is used to register the trusted provider with SharePoint Server. The same provider name will be used as the domain for Microsoft Dynamics AX users that are registered to use the provider.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Port<Int32>

Specifies the port on which the web application will be created.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ProviderAssemblyName<String>

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ProviderTypeName<String>

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SSLCertificate<X509Certificate2>

Specifies the Secure Socket Layers (SSL) certificate that is required to register the site for the trusted identity provider. This parameter is not required for Type ADFS.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ServerUrl<String>

Specifies the Federation Service URL for the Active Directory Federation Service provider that is being registered with SharePoint Server.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SigningCertificate<X509Certificate2>

Specifies the self-signed certificate for the trusted identity provider.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Type<String>

Specifies the type of authentication provider to add. Provider types can be Forms, ADFS, or LiveID.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-UserName<String>

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, OutBuffer, OutVariable, WarningAction, and WarningVariable. For more information, see about_CommonParameters http://go.microsoft.com/fwlink/?LinkID=113216

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

None

You cannot pipe input to this cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

None

The cmdlet does not generate any output.

Examples

Example 1

This example adds a secure socket layers claims based authentication provider to a Microsoft SharePoint Server installation. The variables in the example were given values in previous statements.
$Cred = Get-Credential
$SigningCert = Get-PfxCertificate c:\certs\FORMS-CERT.cer
$SSLSTSCert = Get-PfxCertificate c:\certs\SSLCertForFBA.pfx

C:\PS>Add-AXSharepointClaimsAuthenticationProvider -Type Forms -Name FBAProvider -SigningCertificate $SigningCert -Credential $Cred -Port 7000 -SSLCertificate $SSLSTSCert

Example 2

This example adds a Windows Live ID claims based authentication provider to a Microsoft SharePoint Server installation. The variables in the example were given values in previous statements.
$Cred = Get-Credential
$SigningCert = Get-PfxCertificate c:\certs\LIVEID-CERT.cer
$SSLSTSCert = Get-PfxCertificate C:\certs\SSLCertForLiveID.pfx

C:\PS>Add-AXSharepointClaimsAuthenticationProvider -Type Live -Name LiveIDProvider -SigningCertificate $SigningCert -Credential $Cred -Port 6000 -SSLCertificate $SSLSTSCert

Example 3

This example adds an ADFS claims based authentication provider to a Microsoft SharePoint Server installation. The variables in the example were given values in previous statements.
$SigningCert = Get-PfxCertificate c:\certs\ADFS-CERT.cer

C:\PS>Add-AXSharepointClaimsAuthenticationProvider -Type ADFS -Name ADFSPROVIDER -SigningCertificate $SigningCert -ServerUrl "https://machinename.corp.contoso.com/adfs/ls/"

Flexible Authentication in Microsoft Dynamics AX 2012

Add-AXSharepointClaimsAuthenticationProvider