Repair-NAVCustomization

Repairs user personalizations that are saved in a tenant by recompiling them against the currently installed base application and extensions. Use this cmdlet to fix personlazations that no longer work because of recent changes to base application or extensions in the Business Central Server instance's app catalog.

Syntax

Repair-NAVCustomization
      [-ServerInstance] <String>
      -UserSid <Guid>
      [-Tenant <TenantId>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Repair-NAVCustomization
      [-ServerInstance] <String>
      [-AllUsers]
      [-Tenant <TenantId>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Repair-NAVCustomization
      [-ServerInstance] <String>
      -ProfileId <String>
      -ProfileAppId <Guid>
      [-Tenant <TenantId>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Repair-NAVCustomization
      [-ServerInstance] <String>
      [-AllProfiles]
      [-Tenant <TenantId>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use this cmdlet when a new version of the base application or other extension has been installed to ensure that existing personalizations work properly with any changes that might have been introduced by the new base application or extensions.

You can run the Repair-NAVCustomization cmdlet to globally repair saved page personalizations for all users or for a specific user only.

It is recommended that the Business Central Server instance is restarted after running the repair.

Examples

EXAMPLE 1

Repair-NAVCustomization -ServerInstance BusinessCentral -UserSid 00000000-0000-0000-0000-000000000001

This example repairs the personalizations stored for the default SUPER user.

EXAMPLE 2

Repair-NAVCustomization -ServerInstance BusinessCentral -AllUsers

This example repairs all of personalizations for all users.

Parameters

-AllProfiles

Specifies that all profile customizations must be repaired.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-AllUsers

Specifies whether to repair user personalizations for all users.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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:False
Accept pipeline input:False
Accept wildcard characters:False
-ProfileAppId

Specifies the Id of the extension that defined the profile. Use this parameter if you want to repair the customization made for just one profile.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ProfileId

{{Fill ProfileId Description}}

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
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.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
-Tenant

Specifies the ID of the tenant where you want to repair personalizations, such as Tenant1. This parameter is required unless the specified service instance is not configured to run multiple tenants. If not configured to run multiple tenants, you can either use 'default' as the value or omit the parameter.

Type:TenantId
Aliases:Id
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-UserSid

Specifies the security ID of a Business Central user whose personalizations you want to repair. Use this parameter to repair the personalizations for one user only.

Type:Guid
Position:Named
Default value:00000000-0000-0000-0000-000000000000
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

System.String

By value and by property name: ServerInstance

System.Guid

By property name: UserSid

System.Management.Automation.SwitchParameter

By property name: AllUsers

Microsoft.Dynamics.Nav.Types.TenantId

By property name: Tenant