Set-NAVApplication
Sets the application version or application family fields in the application database connected to the specified Business Central Server instance.
Syntax
Application version (Default)
Set-NAVApplication
[-ServerInstance] <String>
-ApplicationVersion <Version>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Application family
Set-NAVApplication
[-ServerInstance] <String>
-ApplicationFamily <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Increment Application version
Set-NAVApplication
[-ServerInstance] <String>
[-IncrementApplicationVersion]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use the Set-NAVApplication cmdlet to set the applicationversion or applicationfamily fields in the application database connected to the specified Business Central Server instance.
Examples
EXAMPLE 1
Set-NAVApplication -ServerInstance BC -ApplicationVersion '10.0.14824.3'
This example specifies the revision number of applicationversion field in the $ndo$dbproperty table of the application database connected to the specified Business Central Server instance. The example assumes that the existing applicationversion is '10.0.14824.0'.
EXAMPLE 2
Set-NAVApplication -ServerInstance BC -ApplicationVersion '10.0.14840.0' -Force
This example specifies the build number of applicationversion field in the $ndo$dbproperty table of the application database connected to the specified Business Central Server instance. The example assumes that the existing applicationversion is '10.0.14824.0'.
EXAMPLE 3
Set-NAVApplication -ServerInstance BC -ApplicationFamily 'W1'
This example specifies the applicationfamily field in the $ndo$dbproperty table of the application database connected to the specified Business Central Server instance. The example assumes that the existing applicationfamily is '' (empty).
EXAMPLE 4
Set-NAVApplication -ServerInstance BC -ApplicationFamily 'W1' -Force
This example specifies the applicationfamily field in the $ndo$dbproperty table of the application database connected to the specified Business Central Server instance. The example assumes that the existing applicationfamily is non-empty.
EXAMPLE 5
Set-NAVApplication -ServerInstance BC -IncrementApplicationVersion
This example increases by 1 the last number of applicationversion field in the $ndo$dbproperty table of the application database connected to the specified Business Central Server instance. The example assumes that the existing applicationfamily is non-empty.
Parameters
-ApplicationFamily
Specifies the string for the applicationfamily field in the $ndo$dbproperty table of the application database.
If applicationfamily field already has a value in the table, you must use the -Force switch parameter to change the value. Be aware that this change may impact the data upgrade process.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Application family
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-ApplicationVersion
Specifies a formatted string for the applicationversion field in the $ndo$dbproperty table of the application database connected to the specified Business Central Server instance. The string must follow the format 'major.minor[.build[.revision]]', such as '1.1' or '10.0.14824.1'
If you make changes other than increasing 'revision', such as decreasing 'revision' or increasing 'build', then you must use the -Force switch parameter to make the change.
Parameter properties
| Type: | Version |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Application version
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Forces the command to run without asking for user confirmation.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| 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 |
-IncrementApplicationVersion
Increments the last number of applicationversion field (which has the format 'major.minor[.build[.revision]]') in the application database connected to the specified Business Central Server instance. The last number is incremented by 1.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Increment Application version
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| 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.
Inputs
System.Version
By property name: ApplicationVersion
System.String
By property name: ApplicationFamily
System.String
ServerInstance