Get-NAVDataUpgrade
Get-NAVDataUpgrade
Gets information about a data upgrade process that is currently running, or the last completed data upgrade process.
Syntax
Parameter Set: None
Get-NAVDataUpgrade [[-Tenant] <TenantId> ] [-Force] [ <CommonParameters>]
Parameter Set: __AllParameterSets
Get-NAVDataUpgrade [-ServerInstance] <String> [[-Tenant] <TenantId> ] [-Force] [ <CommonParameters>]
Parameter Set: Detailed
Get-NAVDataUpgrade [[-Tenant] <TenantId> ] [[-Detailed]] [-Force] [ <CommonParameters>]
Parameter Set: ErrorOnly
Get-NAVDataUpgrade [[-Tenant] <TenantId> ] [[-ErrorOnly]] [-Force] [ <CommonParameters>]
Parameter Set: Progress
Get-NAVDataUpgrade [[-Tenant] <TenantId> ] [-Progress] [[-Interval] <Int32> ] [-Force] [ <CommonParameters>]
Detailed Description
This information is available until the Microsoft Dynamics NAV Server instance is restarted.
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".
Aliases |
none |
Required? |
false |
Position? |
4 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ErrorOnly
Lists errors that occurred during the data upgrade process.
Aliases |
none |
Required? |
false |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Force
Forces the command to run without asking for user confirmation.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Interval<Int32>
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.
Aliases |
none |
Required? |
false |
Position? |
6 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Progress
Provides live progress indication about the data upgrade process that is currently running.
Aliases |
none |
Required? |
true |
Position? |
5 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ServerInstance<String>
Specifies the Microsoft Dynamics NAV Server instance that is used for the data upgrade. The default instance name is DynamicsNAV90. When a server instance other than the default one is specified, you can use either the full name, such as 'MicrosoftDynamicsNavServer$DynamicsNAV90', or the short name, such as 'DynamicsNAV90'.
Include the name in single-quotes.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue, ByPropertyName) |
Accept Wildcard Characters? |
false |
-Tenant<TenantId>
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.
Aliases |
Id |
Required? |
false |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
System.String
You can pass the value of the ServerInstance and Tenant parameters as a string to this cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- Microsoft.Dynamics.Nav.Types.NavUpgradeProcessExecutionDetails
Examples
--------------------------EXAMPLE 1--------------------------
This example gets information about the data upgrade process that is currently running or the last completed data upgrade process.
PS C:\> Get-NAVDataUpgrade -ServerInstance DynamicsNAV90
TenantId : default
TotalFunctionCount : 3
ExecutedFunctions : 3
Progress : 100.00 %
Details : {Check1, Upg1, Upg2}
Errors :
State : Completed
--------------------------EXAMPLE 2--------------------------
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).
PS C:\> Get-NAVDataUpgrade -ServerInstance DynamicsNAV90 -Progress -Interval 2
Data Upgrade Process is currently in progress...
Percent complete: 0.00 %
[ ]
--------------------------EXAMPLE 3--------------------------
This example returns a detailed status of a currently running or completed data upgrade process.
PS C:\> Get-NAVDataUpgrade -ServerInstance DynamicsNAV90 -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 :
--------------------------EXAMPLE 4--------------------------
This example returns a detailed status of currently running or completed data upgrade process, and displays the details in a table format.
PS C:\> Get-NAVDataUpgrade -ServerInstance DynamicsNAV90 -Details | ogv
The result is displayed in a new window.