In the Business Central, client users can personalize pages (like adding, hiding, and moving page elements like fields, actions and parts). Personalization can be done using the Business Central Web client or the Dynamics NAV Client Connected to Business Central (formerly the Windows client). However, the Dynamics NAV Client and early versions of the Business Central use a different version of personalization than the current Business Central release.
Because of this version difference, users are locked from personalizing a page in the current Business Central Web client if the page was previously only personalized using the Dynamics NAV Client or an early version of Business Central. Users can choose to unlock the page and continue. Unlocking a page converts the old personalization to new version, but it also disconnects the personalization between the Business Central Web client and the Dynamics NAV Client.
You use the Convert-NAVCustomization cmdlet to globally convert all page personalizations from the old version to the latest version; essentially unlocking the pages for users in advance, so they can start personalizing them in the Business Central Web client. You have the option to convert personalization for a specific user or for all users.
This example converts all of the personalizations for all users.
Parameters
-AllProfiles
Specifies to convert all profiles.
Parameter properties
Type:
SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
AllProfilesSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-AllUsers
Specifies that all user personalizations are to be converted.
Parameter properties
Type:
SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
AllUsersSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
cf
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ExportPath
Specifies the path and file name to where you want to export the converted profile(s). Profiles are exported as a ZIP compressed file, so the file name must have the .zip file extension.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ProfileSet
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
AllProfilesSet
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Force
Forces the command to run without asking for user confirmation.
Parameter properties
Type:
SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-OverwriteExisting
Specifies that existing profiles and their corresponding customization should be overwritten. This applies to both saving in the database and exporting to a zip file.
Parameter properties
Type:
SwitchParameter
Default value:
False
Supports wildcards:
False
DontShow:
False
Parameter sets
ProfileSet
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
AllProfilesSet
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-ProfileId
Specifies the name of the profile to convert.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
ProfileSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-ServerInstance
Specifies the Business Central Server instance for the customization.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
0
Mandatory:
True
Value from pipeline:
True
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Tenant
Specifies the ID of the tenant where the user resides, such as Tenant1.
You can specify the value default if the specified server instance is not configured for multiple tenants.
Alternatively, do not set the parameter.
Parameter properties
Type:
TenantId
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
Id
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-UserSid
Specifies the security ID of the Business Central user whose personalization you want to convert.
Parameter properties
Type:
Guid
Default value:
00000000-0000-0000-0000-000000000000
Supports wildcards:
False
DontShow:
False
Parameter sets
SingleUserSet
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-WhatIf
Shows what would happen if the cmdlet runs.
The cmdlet is not run.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
wi
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.