Set-NAVApplication

  • Reference
Module:
Microsoft.BusinessCentral.Management

Sets the application version or application family fields in the application database connected to the specified Business Central Server instance.

Syntax

Set-NAVApplication
   -ApplicationVersion <Version>
   [-ServerInstance] <String>
   [-Force]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-NAVApplication
   -ApplicationFamily <String>
   [-ServerInstance] <String>
   [-Force]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-NAVApplication
   [-IncrementApplicationVersion]
   [-ServerInstance] <String>
   [-Force]
   [-ProgressAction <ActionPreference>]
   [-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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Version
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:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:True
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

Inputs

System.Version

By property name: ApplicationVersion

System.String

By property name: ApplicationFamily

System.String

ServerInstance