Get-NAVDataUpgrade

Gets information about a data upgrade process that is currently running, or the last completed data upgrade process.

Syntax

Get-NAVDataUpgrade
   [[-Tenant] <TenantId>]
   [-ServerInstance] <String>
   [-Force]
   [<CommonParameters>]
Get-NAVDataUpgrade
   [[-Tenant] <TenantId>]
   [-ErrorOnly]
   [-ServerInstance] <String>
   [-Force]
   [<CommonParameters>]
Get-NAVDataUpgrade
   [[-Tenant] <TenantId>]
   [-Detailed]
   [-ServerInstance] <String>
   [-Force]
   [<CommonParameters>]
Get-NAVDataUpgrade
   [[-Tenant] <TenantId>]
   [-Progress]
   [[-Interval] <Int32>]
   [-ServerInstance] <String>
   [-Force]
   [<CommonParameters>]

Description

This information is available until the Business Central Server instance is restarted.

Examples

EXAMPLE 1

Get-NAVDataUpgrade -ServerInstance BC

TenantId           : default


TotalFunctionCount : 3


ExecutedFunctions  : 3


Progress           : 100.00 %


Details            : {Check1, Upg1, Upg2}


Errors             :


State              : Completed

This example gets information about the data upgrade process that is currently running or the last completed data upgrade process.

EXAMPLE 2

Get-NAVDataUpgrade -ServerInstance BC -Progress -Interval 2

Data Upgrade Process is currently in progress...


   Percent complete: 0.00 %


   [                                                                    ]

This example monitors progress of current data upgrade process by requesting the Business Central Server for status every 2 seconds (the default is every second).

EXAMPLE 3

Get-NAVDataUpgrade -ServerInstance BC -Details

SessionId    : 57


CodeunitId   : 111111


FunctionName : Check1


CompanyName  : CRONUS International Ltd.


StartTime    : 6/10/2014 5:45:37 PM


Duration     : 00:00:05.0008043


State        : Completed


Error        :


SessionId    : 58


CodeunitId   : 111111


FunctionName : Upg1


CompanyName  : CRONUS International Ltd.


StartTime    : 6/10/2014 5:45:42 PM


Duration     :


State        : FailedPendingResume


Error        : error.....


SessionId    : 59


CodeunitId   : 111111


FunctionName : Upg2


CompanyName  : CRONUS International Ltd.


StartTime    : 6/10/2014 5:45:42 PM


Duration     : 00:00:02.0071301


State        : Completed


Error        :

This example returns a detailed status of a currently running or completed data upgrade process.

Required Parameters

-Progress

Provides live progress indication about the data upgrade process that is currently running.

Type:SwitchParameter
Position:4
Default value:None
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. Include the name in single-quotes.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False

Optional Parameters

-Detailed

Lists details about all the upgrade function that were invoked during the data upgrade process. You can format the output as a table by appending the command with "| ft" or "| ogv".

Type:SwitchParameter
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ErrorOnly

Lists errors that occurred during the data upgrade process.

Type:SwitchParameter
Position:2
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
-Interval

Specifies how often (in seconds) the cmdlet requests the current status of data upgrade process. This parameter can only be used together with the -Progress switch. The default value is 1 second.

Type:Int32
Position:5
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Tenant

Specifies the ID of a tenant on the Business Central Server instance. You can omit the Tenant parameter only if the Business Central Server instance is not configured to run multiple tenants.

Type:TenantId
Aliases:Id
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Inputs

System.String

You can pass the value of the ServerInstance and Tenant parameters as a string to this cmdlet.

Outputs

Microsoft.Dynamics.Nav.Types.NavUpgradeProcessExecutionDetails