Get-NAVDataUpgrade
Gets information about a data upgrade process that is currently running, or the last completed data upgrade process.
Syntax
None (Default)
Get-NAVDataUpgrade
[[-Tenant] <TenantId>]
[-ServerInstance] <String>
[-Force]
[<CommonParameters>]
ErrorOnly
Get-NAVDataUpgrade
[[-Tenant] <TenantId>]
[-ServerInstance] <String>
[-ErrorOnly]
[-Force]
[<CommonParameters>]
Detailed
Get-NAVDataUpgrade
[[-Tenant] <TenantId>]
[-ServerInstance] <String>
[-Detailed]
[-Force]
[<CommonParameters>]
Progress
Get-NAVDataUpgrade
[[-Tenant] <TenantId>]
[[-Interval] <Int32>]
[-ServerInstance] <String>
[-Progress]
[-Force]
[<CommonParameters>]
Description
This information is available until the Microsoft Dynamics NAV Server instance is restarted.
Examples
EXAMPLE 1
Get-NAVDataUpgrade -ServerInstance DynamicsNAV
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 DynamicsNAV -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 Microsoft Dynamics NAV Server for status every 2 seconds (the default is every second).
EXAMPLE 3
Get-NAVDataUpgrade -ServerInstance DynamicsNAV -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".
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Detailed
| Position: | 4 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ErrorOnly
Lists errors that occurred during the data upgrade process.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ErrorOnly
| Position: | 3 |
| 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: | 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 |
-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.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Progress
| Position: | 6 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Progress
Provides live progress indication about the data upgrade process that is currently running.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Progress
| Position: | 5 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ServerInstance
Specifies the name of a Dynamics NAV Server instance, for example, DynamicsNAV 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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Tenant
Specifies the ID of a tenant on the Microsoft Dynamics NAV Server instance. You can omit the Tenant parameter only if the Microsoft Dynamics NAV Server instance is not configured to run multiple tenants.
Parameter properties
| Type: | TenantId |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Id |
Parameter sets
(All)
| Position: | 2 |
| 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
You can pass the value of the ServerInstance and Tenant parameters as a string to this cmdlet.