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 -Detailed
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.
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 |
Required: | False |
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 |
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 |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Progress
Provides live progress indication about the data upgrade process that is currently running.
Type: | SwitchParameter |
Position: | 4 |
Default value: | None |
Required: | True |
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 |
Required: | True |
Accept pipeline input: | True |
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 |
Required: | False |
Accept pipeline input: | True |
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