New-AXClaimsAwareEnterprisePortalServer
Important
This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.
New-AXClaimsAwareEnterprisePortalServer
Creates a claims-aware instance of Enterprise Portal.
Syntax
Parameter Set: Default
New-AXClaimsAwareEnterprisePortalServer [-ClearTextPassword <String> ] [-Credential <PSCredential> ] [-Port <Int32> ] [-SSLCertificate <X509Certificate2> ] [-UseNTLMExclusively] [-UserName <String> ] [ <CommonParameters>]
Detailed description
The New-AXClaimsAwareEnterprisePortalServer cmdlet creates a claims-aware SharePoint web application and installs an instance of Enterprise Portal.
Parameters
-ClearTextPassword<String>
Sends the password of the business connector proxy in clear text, rather than encrypted. UserName and ClearTextPassword are a way to specify the business connector proxy account. They cannot be used with the Credential parameter. UserName and ClearTextPassword are often used in scripts in which no user interaction is expected.
When the cmdlet is executed, this account is added to the list of SharePoint farm administrators. Also, the claims-based Enterprise Portal SharePoint web application uses this account as its IIS application pool identity.
Important: Using an account other than the business connector proxy account can result in errors when accessing Microsoft Dynamics AX through Enterprise Portal.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Credential<PSCredential>
Specifies an account with administrator privileges on the SharePoint site. You must use the Business Connector proxy account. The Credential parameter cannot be used with the UserName and ClearTextPassword parameters.
When the cmdlet is executed, this account is added to the list of SharePoint farm administrators. Also, the claims-based Enterprise Portal SharePoint web application uses this account as its IIS application pool identity.
Important: Using an account other than the business connector proxy account can result in errors when accessing Microsoft Dynamics AX through Enterprise Portal.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Port<Int32>
Specifies which port to install Enterprise Portal on. This must be a port that is not already in use. If you attempt to create a web application on a port that is already in use, an error is returned.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-SSLCertificate<X509Certificate2>
Specifies the secure socket layer (SSL) certificate to use for Enterprise Portal. The common name (CN) of the SSL certificate must be the name of the computer that you are installing Enterprise Portal on and are running the cmdlet on.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-UseNTLMExclusively
Configures the web application for Enterprise Portal to use the NTLM method of Windows authentication.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-UserName<String>
Specifies the username of the administrator for the SharePoint Server web application that will be created. You must use the Business Connector proxy account.
UserName and ClearTextPassword are a way to specify the business connector proxy account. They cannot be used with the Credential parameter. UserName and ClearTextPassword are often used in scripts in which no user interaction is expected.
When the cmdlet is executed, this account is added to the list of SharePoint farm administrators. Also, the claims-based Enterprise Portal SharePoint web application uses this account as its IIS application pool identity.
Important: Using an account other than the business connector proxy account can result in errors when accessing Microsoft Dynamics AX through Enterprise Portal.
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 https://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
This example creates a claims aware SharePoint web application that uses Secure Socket Layers and installs an instance of Enterprise Portal on port 5000. The variables in the example were given values in previous statements.
$Cred = Get-Credential
$SSLCert = Get-PfxCertificate c:\certs\SSLCertForEP.pfx
C:\PS>New-AXClaimsAwareEnterprisePortalServer -Credential $Cred -Port 5000 -SSLCertificate $SSLCert
Copyright Microsoft Corporation. All rights reserved.