Start-NAVAppDataUpgrade
Upgrades a NAV App to a specified tenant.
Syntax
Properties
Start-NAVAppDataUpgrade
[-ServerInstance] <String>
-Name <String>
[-Publisher <String>]
[-Version <Version>]
[-Tenant <TenantId>]
[-Language <LanguageSetting>]
[-ExclusiveAccessTicket <String>]
[-PassThru]
[-Force]
[<CommonParameters>]
Path
Start-NAVAppDataUpgrade
[-ServerInstance] <String>
-Path <String>
[-Tenant <TenantId>]
[-Language <LanguageSetting>]
[-ExclusiveAccessTicket <String>]
[-PassThru]
[-Force]
[<CommonParameters>]
Description
Use the Start-NAVAppDataUpgrade cmdlet to upgrade the data from a old version of Nav App to a new version of Nav App in the tenant database.
Examples
---------- EXAMPLE 1 ----------
Start-NAVAppDataUpgrade -ServerInstance DynamicsNAV -Name 'Proseware SmartApp' -Version 2.3.4.500 -Tenant 'Tenant1'
This example upgrades the NAV App with the specified name and version for the tenant with the ID Tenant1.
---------- EXAMPLE 2 ----------
Get-NAVAppInfo -ServerInstance DynamicsNAV -Name 'Proseware SmartApp' -Version 2.3.4.500 | Start-NAVAppDataUpgrade -Tenant 'Tenant1'
This example upgrades a NAV App that is returned from the Get-NAVAppInfo cmdlet for the tenant with the ID Tenant1.
---------- EXAMPLE 3 ----------
Start-NAVAppDataUpgrade -ServerInstance DynamicsNAV -Path '.\Proseware SmartApp.navx' -Tenant 'Tenant1'
This example upgrades the NAV App at the specified path for the tenant with the ID Tenant1.
---------- EXAMPLE 4 ----------
Start-NAVAppDataUpgrade -ServerInstance DynamicsNAV -Name 'Proseware SmartApp' -Version 2.3.4.500 -Tenant 'Tenant1' -ExclusiveAccessTicket $ticket
This example upgrades the NAV App with the specified name and version for the tenant with the ID Tenant1. Tenant1 is in exclusive access mode and $ticket is the exclusive access ticket.
Parameters
-ExclusiveAccessTicket
Specifies the exclusive access ticket allowing this operation on the tenant in the exclusive access mode.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| 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: | True |
| Value from remaining arguments: | False |
-Language
Specifies the language version of Dynamics NAV app. The value must be a valid culture name for a language in Microsoft Dynamics NAV, such as en-US or da-DK. If the specified language does not exist on the Microsoft Dynamics NAV Server instance, then en-US is used.
Parameter properties
| Type: | LanguageSetting |
| Default value: | None |
| 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 |
-Name
Specifies the name of the NAV App that you want to upgrade. The results must return only one NAV App, otherwise nothing upgrades.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | AppName |
Parameter sets
Properties
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-PassThru
Returns a NAV App object for the upgraded NAV App. The NAV App object contains the properties of the NAV App, such as name, publisher, and version.
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 |
-Path
Specifies the path to a NAV App package file that you want to upgrade for the tenant. The NAV App must have already been published and synced to the server instance before you can upgrade it for the tenant.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Path
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Publisher
Specifies the publisher of the NAV App that you want to upgrade. The results must return only one NAV App, otherwise nothing upgrades.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | AppPublisher |
Parameter sets
Properties
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-ServerInstance
Specifies the Microsoft Dynamics NAV Server instance that the NAV App is published to, such as DynamicsNAV.
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 |
-Tenant
Specifies the ID of the tenant that you want to upgrade the NAV App for, such as Tenant1. You can specify the value 'default' if the specified server instance is not configured for multiple tenants. Alternatively, do not set the parameter.
Parameter properties
| Type: | TenantId |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Id |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Version
Specifies the version of the NAV App that you want to upgrade. The version of upgraded NAV App must be greater than current installed/uninstalled NAV App , otherwise nothing upgrades.
Parameter properties
| Type: | Version |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | AppVersion |
Parameter sets
Properties
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| 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.String
By value and by property name: ServerInstance
System.String
By property name: Name
System.String
By property name: Publisher
System.Version
By property name: Version
Microsoft.Dynamics.Nav.Types.TenantId
By property name: Tenant
System.String
By property name: Path
System.String
By value and by property name: ExclusiveAccessTicket
System.Management.Automation.SwitchParameter
Forces the command to run without asking for user confirmation.