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>]
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
-AllUsers
Specifies whether to repair user personalizations for all users.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
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: | False |
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.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
Required: | False |
Accept pipeline input: | True |
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 |
Required: | True |
Accept pipeline input: | True |
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 |
Required: | False |
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
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for