Share via

Resume-NAVDataUpgrade

  • Reference
Module:
Microsoft.BusinessCentral.Management

Resumes a suspended data upgrade process.

Syntax

Resume-NAVDataUpgrade
      [[-Tenant] <TenantId>]
      [-ServerInstance] <String>
      [-Force]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-NAVDataUpgrade
      [[-Tenant] <TenantId>]
      [-CodeunitId] <Int32>
      [-FunctionName] <String>
      [[-CompanyName] <String>]
      [-ServerInstance] <String>
      [-Force]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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.

Examples

EXAMPLE 1

Resume-NAVDataUpgrade -ServerInstance BC

This example resumes a currently suspended data upgrade process.

EXAMPLE 2

Resume-NAVDataUpgrade -ServerInstance BC -CodeunitId 111111 -FunctionName Upg1 -CompanyName

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.

Parameters

-CodeunitId

Specifies the ID of the upgrade codeunit to run.

Type:Int32
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CompanyName

Specifies the name of the company for which to run the upgrade codeunit function.

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
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

-FunctionName

Specifies the name of the upgrade function to run.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ProgressAction

A common PowerShell parameter that determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider. Learn more.

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
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

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.String

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

Notes

The Resume-NAVUpgrade cmdlet runs in the same language that was used in the Start-NAVUpgrade cmdlet, as specified by the -Language parameter.