{"title":"Business Central Administration Shell","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/administration-shell/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/administration-shell, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/administration-shell","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Read about the PowerShell cmdlets managing Business Central Server instances and extensions for on-premises deployments.","date":"2026-09-01","meta":{"topic":"article"},"outline":[{"level":1,"title":"Business Central Administration Shell","slug":"business-central-administration-shell","at":0,"chars":6286},{"level":2,"title":"Install the Business Central Admin Shell","slug":"install-the-business-central-admin-shell","at":366,"chars":2248},{"level":3,"title":"About the PowerShell modules","slug":"about-the-powershell-modules","at":787,"chars":1827},{"level":2,"title":"Run the Business Central Administration Shell","slug":"run-the-business-central-administration-shell","at":2614,"chars":997},{"level":2,"title":"Run Business Central Admin Shell in remote session","slug":"run-business-central-admin-shell-in-remote-session","at":3611,"chars":1401},{"level":2,"title":"Get help on the cmdlets","slug":"get-help-on-the-cmdlets","at":5012,"chars":1047},{"level":3,"title":"Learn more","slug":"learn-more","at":5719,"chars":340},{"level":2,"title":"Related information","slug":"related-information","at":6059,"chars":227}],"text":"# Business Central Administration Shell\nThe Business Central Administration Shell includes PowerShell cmdlets for administering Business Central on-premises deployments. You use it for configuring Business Central Server and Web server instances, databases, users, and more. You also use it to manage extensions, like publishing, syncing, installing, and upgrading.\n## Install the Business Central Admin Shell\nThe Business Central Administration Shell is installed together with Business Central Server components by using the Business Central Setup wizard. To install it, run the setup.exe that's available on the installation media (DVD). Follow the wizard, and choose either the Install Demo option or the Server option in the customized setup. See ../deployment/install-using-setup.\n### About the PowerShell modules\nBusiness Central Administration Shell consists of the following PowerShell script modules, which are stored in the Business Central Server installation Admin folder:\n Microsoft.BusinessCentral.Management<https://learn.microsoft.com/powershell/module/Microsoft.Dynamics.Nav.Management> - Cmdlets for administering Business Central Server instances\n Microsoft.BusinessCentral.Apps.Management<https://learn.microsoft.com/powershell/module/Microsoft.Dynamics.Nav.Apps.Management> - Cmdlets for administering Business Central extensions and apps\n https://learn.microsoft.com/powershell/module/NAVWebClientManagement - Cmdlets for administering Business Central Web Server instances\nThe Microsoft.BusinessCentral.Apps.Tools<https://learn.microsoft.com/powershell/module/Microsoft.Dynamics.Nav.Apps.Tools> module provides cmdlets for creating Business Central extension packages and exporting related application data and resources. This module isn't part of Business Central Administration Shell and must be imported separately.\nOnly PowerShell 7 is supported. Windows PowerShell 5 might continue to work, but it isn't a supported configuration and might stop working in a future update.\nEarlier versions\nIn 2026 release wave 1 (version 28) and earlier, modules are available as binary modules (.dll) for PowerShell 7 and in a PowerShell 5 compatibility layer. Windows PowerShell 5 compatibility layer consolidates the modules into a single module that can run with PowerShell 5. The module, Microsoft.Dynamics.Nav.Management.dll, is part of Business Central Server installation Management folder. Learn more about compatibility in Windows PowerShell Compatibility in PowerShell 7<https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_windows_powershell_compatibility>.\n## Run the Business Central Administration Shell\nTo run the shell, you have to be a member of the local administrator group on the computer. There are a couple ways to run the shell.\n One way is from the Start menu or Search on your desktop. Select Start or Search, type Business Central Administration Shell, right-click it, then select Run as administrator.\n  If PowerShell 7 is installed on your device, then the PowerShell 7 modules are loaded\n Another way is from Windows PowerShell. Start PowerShell 7 (or Windows PowerShell 5) as an administrator. At the prompt, run the following command:\n  ```powershell\n  Import-Module -Name C:\\Program Files\\Microsoft Dynamics 365 Business Central\\nnn\\Service\\navadmintool.ps1\n  ```\n  Replace `C:\\Program Files\\Microsoft Dynamics 365 Business Central\\nnn` with the path to your server installation.\n  If you're using PowerShell 7, the PowerShell 7 modules are loaded. If you're using PowerShell 5, the PowerShell 5 compatibility layer module is loaded.\n## Run Business Central Admin Shell in remote session\nTo administer Business Central Server on a remote computer, you can use PowerShell remoting. PowerShell remoting allows you to run Business Central Administration Shell cmdlets on the remote server from your local machine.\n1. Ensure that PowerShell Remoting is enabled on the remote computer that's running Business Central Server. From the remote computer, start PowerShell and run the following command:\n ```powershell\n Enable-PSRemoting -Force\n ```\n1. On the local computer, start PowerShell 7 (or Windows PowerShell 5) as an administrator.\n1. Run the following command to start an interactive session to the remote computer:\n ```powershell\n Enter-PSSession -ComputerName <RemoteComputerName> -Credential <Username>\n ```\n Once connected, your prompt changes to reflect the remote computer. You can now navigate and execute commands directly.\n1. Run the following command to start Business Central Administration Shell:\n ```powershell\n  Import-Module -Name C:\\Program Files\\Microsoft Dynamics 365 Business Central\\nnn\\Service\\navadmintool.ps1\n ```\n> IMPORTANT\n> With 2026 release wave 1 (v28.0), you must use Windows PowerShell 5 to run Business Central Administration Shell. Due to a known issue, PowerShell 7-based remoting isn't supported. See ../upgrade/known-issues#business-central-admin-shell-modules-fail-in-powershell7-remote-sessions.\n## Get help on the cmdlets\nTo view the available cmdlets, enter the following command at the prompt:\n```powershell\nGet-Command *NAV*\n```\nTo get help with syntax, options, and examples for a specific cmdlet in Business Central version 23 or earlier, enter the following command:\n```powershell\nGet-Help <cmd name> -full\n```\nFor example, to get Help about the Get-NAVServerInstance cmdlet, type the following command.\n```powershell\nGet-Help Get-NAVServerInstance -full\n```\nHelp with syntax, options, and examples isn't available starting with version 24. Use the online version of the help on Microsoft Learn.\nTo open the online help, enter the following command:\n```powershell\nGet-Help <cmd name> -online\n```\n### Learn more\nFor more information about Business Central Administration Shell cmdlets, see Administration Cmdlets <https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management>.\nFor more information about Windows PowerShell, see Windows PowerShell Getting Started Guide<https://go.microsoft.com/fwlink/?LinkID=252252>.\n## Related information\nConfiguring Business Central Server Instances<configure-server-instance>\nConfiguring Business Central Web Server Instances<configure-web-server>\n../developer/devenv-how-publish-and-install-an-extension-v2"}