New-NAVServerAppConfiguration
Creates a new application-specific configuration file for the Business Central Server instance.
Syntax
New-NAVServerAppConfiguration
-ApplicationId <String>
[-ServerInstance] <String>
[-Force]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
You can have more than one application running on a single Business Central Server instance. By default, the server instance will use the settings in the CustomSettings.config for all applications. This cmdlet enables you to create an additional configuration file that is only used by a specific application. The application-specific configuration file can be used to configure the following settings.
AppProtocolName - Specifies the protocol to use in URL links to the application, similar to the http protocol in web page links. For example, with Dynamics 365 for Financials, by setting the parameter to "ms-financials" means that "ms-financials:///?page=31" would open the items list page 31.
AppIdUri - Specifies the APP ID URI that is assigned to the Business Central application in Microsoft Entra ID (Microsoft Entra ID).
AzureActiveDirectoryClientApplicationId - Specifies the CLIENT ID that is assigned to the Business Central application in Microsoft Entra ID.
The application-specific file is saved in the same location as the CustomSettings.config file for the Business Central Server installation. For example, by default, the location is C:\Program Files\Business Central\NN\Service, where NN is the server version number.
The generated configuration file does not contain any settings. To add settings, use the Set-NAVServerAppConfiguration cmdlet.
The application-specific configuration file is used to supplement the CustomSettings.config file of the server instance. The server instance will load the correct application-specific configuration file for an application based on the application ID that is specified by the ApplicationId parameter.
Examples
EXAMPLE 1
New-NAVServerAppConfiguration -ApplicationId FIN -ServerInstance BC
This example creates a new application-specific configuration file for the FIN application. The generated file has the name CustomerSettings.FIN.config.
Parameters
-ApplicationId
Specifies the identifier that is assigned to the application to create a configuration file for. The value is used in the name of the new configuration file, which has the format: CustomSettings.ApplicationId.config.
For Business Central on-premises, the default application ID is NAV
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Forces the command to run without asking for user confirmation.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProgressAction
A common PowerShell parameter that determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider. Learn more.
Type: | ActionPreference |
Aliases: | proga |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerInstance
Specifies the name of a Business Central Server instance, for example, BC or myinstance. You can specify either the full name of an instance, such as MicrosoftDynamicsNavServer$myinstance or the short name such as myinstance.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |