Resume-NAVDataUpgrade
Resume-NAVDataUpgrade
Resumes a suspended data upgrade process.
Syntax
Parameter Set: AllMethods
Resume-NAVDataUpgrade [[-Tenant] <TenantId> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: __AllParameterSets
Resume-NAVDataUpgrade [-ServerInstance] <String> [[-Tenant] <TenantId> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SingleMethod
Resume-NAVDataUpgrade [[-Tenant] <TenantId> ] [-CodeunitId] <Int32> [-FunctionName] <String> [[-CompanyName] <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
You can choose to re-run all previously failed and cancelled upgrade functions or choose a specific upgrade function.
Only failed or cancelled upgrade functions can be re-run. To get a list of invoked functions, use the Get-NAVDataUpgrade cmdlet.
It is not possible to resume the data upgrade process if it was stopped by the Stop-NAVDataUpgrade cmdlet.
Parameters
-CodeunitId<Int32>
Specifies the ID of the upgrade codeunit to run.
Aliases |
none |
Required? |
true |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-CompanyName<String>
Specifies the name of the company for which to run the upgrade codeunit function.
Aliases |
none |
Required? |
false |
Position? |
5 |
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 |
-FunctionName<String>
Specifies the name of the upgrade function to run.
Aliases |
none |
Required? |
true |
Position? |
4 |
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 |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
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 CodunitId, CompanyName, FunctionName, ServerInstance and Tenant parameters as a string to this cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- None
Examples
--------------------------EXAMPLE 1--------------------------
This example resumes a currently suspended data upgrade process.
PS C:\> Resume-NAVDataUpgrade -ServerInstance DynamicsNAV90
--------------------------EXAMPLE 2--------------------------
This example resumes currently suspended data upgrade process by invoking a specific upgrade function that previously failed or was cancelled. This approach can be useful for gradually fixing and rerunning upgrade functions without having to restore the full database and start from beginning.
PS C:\> Resume-NAVDataUpgrade -ServerInstance DynamicsNAV90 -CodeunitId 111111 -FunctionName Upg1 -CompanyName