The cmdlets de Dynamics NAV 2017 Administration Shell permiten administrar diferentes elementos de una instalación de Microsoft Dynamics NAV mediante Windows PowerShell, automatizando tareas sobre servidores, bases de datos, usuarios, permisos y servicios.
Microsoft Dynamics NAV 2017 incorpora un conjunto de cmdlets de PowerShell destinados a facilitar tanto la administración de Dynamics NAV como determinadas tareas de desarrollo y gestión de archivos, objetos de aplicación y paquetes de extensión.
Para los administradores de sistemas y profesionales técnicos, utilizar estos comandos puede simplificar tareas repetitivas y facilitar la automatización de determinadas operaciones.
En este artículo nos centraremos en los cmdlets disponibles en Dynamics NAV 2017 Administration Shell, especialmente en los incluidos en el módulo Microsoft.Dynamics.Nav.Management.
¿Qué es Dynamics NAV 2017 Administration Shell?
Dynamics NAV 2017 Administration Shell es una interfaz basada en Windows PowerShell que permite administrar diferentes componentes de una instalación de Microsoft Dynamics NAV.
Los cmdlets de administración permiten realizar tareas como:
- Configurar instancias de Dynamics NAV Server.
- Administrar bases de datos y empresas.
- Gestionar usuarios y permisos.
- Consultar sesiones activas.
- Configurar servicios web.
- Gestionar determinadas configuraciones del servidor.
- Realizar operaciones relacionadas con datos y actualizaciones.
- Administrar otros componentes del despliegue.
Microsoft indica que los cmdlets de administración de NAV están incluidos en el módulo Microsoft.Dynamics.Nav.Management, instalado junto con Dynamics NAV Server.
¿Qué son los cmdlets de Dynamics NAV?
Los cmdlets son comandos específicos de PowerShell que permiten realizar determinadas operaciones de administración mediante instrucciones de texto.
En lugar de realizar determinadas tareas manualmente desde las herramientas gráficas de Dynamics NAV, un administrador puede utilizar PowerShell para ejecutar comandos de forma controlada y, en determinados escenarios, automatizada.
Por ejemplo, existen cmdlets para:
- Obtener información (Get-NAV…).
- Crear elementos (New-NAV…).
- Modificar configuraciones (Set-NAV…).
- Eliminar elementos (Remove-NAV…).
- Importar información (Import-NAV…).
- Exportar información (Export-NAV…).
- Iniciar o detener determinados procesos.
Esta estructura facilita identificar rápidamente qué operación queremos realizar.
Módulos de PowerShell disponibles en Dynamics NAV 2017
Los cmdlets de Dynamics NAV no se encuentran todos en un único módulo.
Microsoft diferencia entre los cmdlets de la Administration Shell y los de la Development Shell, con módulos específicos para diferentes tareas. En NAV 2017, Microsoft.Dynamics.Nav.Management se utiliza para la administración del despliegue, mientras que existen otros módulos para extensiones y desarrollo.
Microsoft.Dynamics.Nav.Management
Es el módulo principal para la administración de Dynamics NAV 2017.
Incluye cmdlets relacionados con:
- Instancias de servidor.
- Bases de datos.
- Empresas.
- Usuarios.
- Permissions.
- Sesiones.
- Servicios web.
- Settings.
- Actualizaciones de datos.
Microsoft.Dynamics.Nav.Apps.Management
Está orientado a la administración de paquetes de extensión de Dynamics NAV.
Entre sus operaciones se encuentran la publicación, instalación, desinstalación y gestión de aplicaciones.
Otros módulos de Dynamics NAV
La documentación de Microsoft también diferencia los módulos relacionados con la Development Shell, destinados a tareas de desarrollo y gestión de objetos de aplicación.
Por tanto, conviene distinguir entre Administration Shell y Development Shell antes de buscar un cmdlet concreto.
Principales cmdlets de Dynamics NAV 2017 Administration Shell
A continuación se recoge una selección de los principales cmdlets incluidos en el módulo Microsoft.Dynamics.Nav.Management para NAV 2017.
Cmdlets Get-NAV: consultar información
Los cmdlets que comienzan por Get-NAV permiten obtener información sobre diferentes elementos de Dynamics NAV.
Algunos de los más interesantes son:
- Get-NAVDataUpgrade: Consulta información sobre un proceso de actualización de datos.
- Get-NAVServerConfiguration: Obtiene la configuración de una instancia de Dynamics NAV Server.
- Get-NAVServerInstance: Obtiene información sobre una instancia de servidor.
- Get-NAVServerPermission: Consulta permisos aplicados a objetos de Dynamics NAV.
- Get-NAVServerPermissionSet: Obtiene los conjuntos de permisos disponibles.
- Get-NAVServerSession: Consulta las sesiones activas.
- Get-NAVServerUser: Obtiene información sobre los usuarios de Dynamics NAV.
- Get-NAVServerUserPermissionSet: Consulta los conjuntos de permisos asignados a usuarios.
- Get-NAVTenant: Obtiene información sobre los tenants montados.
- Get-NAVWebService: Obtiene información sobre los servicios web configurados.
Estos comandos resultan especialmente útiles cuando necesitamos consultar el estado de una instalación de Dynamics NAV sin tener que revisar manualmente cada elemento.
Cmdlets New-NAV: crear elementos
Los cmdlets New-NAV permiten crear determinados elementos de la instalación.
Entre ellos encontramos:
- New-NAVCompany: Crea una nueva empresa.
- New-NAVDatabase: Crea una base de datos de Dynamics NAV a partir de una copia de seguridad.
- New-NAVEncryptionKey: Crea una clave de cifrado.
- New-NAVServerInstance: Crea una nueva instancia de Dynamics NAV Server.
- New-NAVServerPermission: Añade un permiso a un conjunto de permisos.
- New-NAVServerPermissionSet: Crea un conjunto de permisos.
- New-NAVServerUser: Crea un nuevo usuario.
- New-NAVServerUserPermissionSet: Asigna un conjunto de permisos a un usuario.
- New-NAVTableConnection: Registra una conexión con una tabla de una base de datos externa.
- New-NAVWebServerInstance: Crea una instancia de servidor web.
- New-NAVWebService: Crea un servicio web.
Cmdlets Set-NAV: modificar configuraciones
Los comandos Set-NAV permiten modificar diferentes configuraciones y elementos existentes.
Entre los principales encontramos:
- Set-NAVServerConfiguration
- Set-NAVServerAppConfiguration
- Set-NAVServerInstance
- Set-NAVServerPermission
- Set-NAVServerPermissionSet
- Set-NAVServerUser
- Set-NAVWebServerInstanceConfiguration
Por ejemplo, Set-NAVServerConfiguration permite establecer la configuración de una instancia de Dynamics NAV Server.
Cmdlets Remove-NAV: eliminar elementos
Los cmdlets que comienzan por Remove-NAV permiten eliminar determinados elementos de la instalación.
Entre ellos:
- Remove-NAVCompany: Elimina una empresa.
- Remove-NAVServerInstance: Elimina una instancia de Dynamics NAV Server.
- Remove-NAVServerPermission: Elimina un permiso.
- Remove-NAVServerPermissionSet: Elimina un conjunto de permisos.
- Remove-NAVServerSession: Cierra una sesión de cliente.
- Remove-NAVServerUser: Elimina un usuario.
- Remove-NAVServerUserPermissionSet: Elimina un conjunto de permisos asignado a un usuario.
- Remove-NAVTableConnection: Elimina una conexión a una tabla externa.
- Remove-NAVWebServerInstance: Elimina una instancia de servidor web.
- Remove-NAVWebService: Elimina servicios web especificados.
Estas operaciones deben ejecutarse con especial precaución, especialmente cuando afectan a usuarios, empresas, permisos o componentes del servidor.
Cmdlets Import-NAV y Export-NAV
Dynamics NAV 2017 también incorpora comandos destinados a importar y exportar información.
Entre ellos destacan:
- Export-NAVApplication
- Export-NAVData
- Export-NAVEncryptionKey
- Export-NAVServerLicenseInformation
- Import-NAVData
- Import-NAVEncryptionKey
- Import-NAVServerLicense
Estos cmdlets pueden resultar útiles en tareas de administración, migración, configuración y mantenimiento de entornos Dynamics NAV.
Cmdlets para administrar servidores, usuarios y servicios
Una de las principales ventajas de Dynamics NAV Administration Shell es que permite centralizar mediante PowerShell numerosas tareas de administración.
Por ejemplo, un administrador puede consultar:
Instancias de servidor
Get-NAVServerInstance
Usuarios
Get-NAVServerUser
Permisos
Get-NAVServerPermission
Sesiones
Get-NAVServerSession
Servicios web
Get-NAVWebService
Esta posibilidad resulta especialmente interesante en entornos donde existen varias instancias o donde es necesario repetir determinadas tareas de administración.
Cmdlets para gestionar empresas y tenants
También existen comandos específicos para trabajar con las empresas y los tenants de Dynamics NAV.
Some examples are:
- Get-NAVCompany
- New-NAVCompany
- Copy-NAVCompany
- Remove-NAVCompany
- Rename-NAVCompany
- Get-NAVTenant
- Mount-NAVTenant
- Dismount-NAVTenant
- Sync-NAVTenant
Estos cmdlets permiten automatizar operaciones que, dependiendo del entorno, pueden requerir bastante trabajo manual.
Actualización de datos mediante PowerShell
La Administration Shell también incluye comandos relacionados con los procesos de actualización de datos.
Entre ellos destacan:
- Get-NAVDataUpgrade
- Start-NAVDataUpgrade
- Stop-NAVDataUpgrade
- Resume-NAVDataUpgrade
Esto permite consultar y controlar determinados procesos de actualización desde PowerShell.
Administración de extensiones en Dynamics NAV 2017
Además de los cmdlets de administración general, Dynamics NAV 2017 incluye herramientas específicas para administrar extensiones.
El módulo Microsoft.Dynamics.Nav.Apps.Management incorpora comandos como:
- Get-NAVAppInfo
- Get-NAVAppTenant
- Install-NAVApp
- Publish-NAVApp
- Repair-NAVApp
- Uninstall-NAVApp
- Unpublish-NAVApp
Estos comandos permiten gestionar el ciclo de vida de las aplicaciones y extensiones en NAV.
¿Qué ventajas ofrecen los cmdlets de Dynamics NAV?
Utilizar PowerShell para administrar Dynamics NAV puede aportar varias ventajas:
Automation
Las tareas repetitivas pueden integrarse en scripts y ejecutarse de forma más eficiente.
Centralized administration
Permite gestionar diferentes elementos del entorno desde una misma consola.
More speed
Una operación que requiere varios pasos desde la interfaz puede resolverse mediante un único comando o script.
Repetibilidad
Los scripts permiten ejecutar una misma configuración de forma consistente en diferentes entornos.
Diagnóstico
Los cmdlets Get-NAV facilitan la consulta del estado de servidores, usuarios, permisos y otros elementos.
Precauciones al utilizar PowerShell con Dynamics NAV
Los cmdlets de administración permiten realizar operaciones que pueden afectar directamente al entorno de Dynamics NAV. Por ello, es importante comprobar siempre el comando y sus parámetros antes de ejecutarlo.
Microsoft también advierte que algunos cmdlets pueden realizar operaciones equivalentes a las disponibles desde el cliente, pero no ejecutan necesariamente la lógica añadida a los objetos de aplicación asociados. Por ejemplo, la creación de determinados servicios mediante New-NAVWebService no ejecuta lógica personalizada añadida al objeto correspondiente.
Por este motivo, en entornos de producción es recomendable:
- Probar previamente los comandos.
- Revisar los parámetros utilizados.
- Realizar copias de seguridad cuando corresponda.
- Evitar ejecutar comandos destructivos sin comprobar su impacto.
- Documentar los scripts utilizados.
- Diferenciar claramente los entornos de desarrollo, pruebas y producción.
¿Dónde consultar todos los cmdlets de Dynamics NAV 2017?
La documentación oficial de Microsoft incluye la referencia de los cmdlets de Dynamics NAV 2017, junto con su sintaxis, parámetros y ejemplos.
Puedes consultar la documentación oficial del módulo Microsoft.Dynamics.Nav.Management en Microsoft Learn – Microsoft.Dynamics.Nav.Management.
Microsoft también dispone de una referencia general sobre los cmdlets de Windows PowerShell para Dynamics NAV, donde se explica la diferencia entre Administration Shell y Development Shell y se agrupan los distintos módulos disponibles.
Conclusion
The cmdlets de Dynamics NAV 2017 Administration Shell proporcionan a administradores y técnicos una herramienta muy potente para gestionar el entorno mediante PowerShell.
Desde la consulta de usuarios y permisos hasta la creación de empresas, configuración de servidores, gestión de servicios web o administración de extensiones, los cmdlets permiten automatizar numerosas tareas de administración de Dynamics NAV.
Aunque Dynamics NAV 2017 es una versión anterior del ERP de Microsoft, esta funcionalidad sigue siendo especialmente relevante para organizaciones que mantienen entornos NAV on-premises y necesitan administrarlos de forma eficiente.
¿Necesitas ayuda con la administración de Dynamics NAV?
At ABD Consulting and IT Solutions contamos con experiencia en Microsoft Dynamics NAV and Dynamics 365 Business Central, ayudando a las empresas a administrar, mantener y evolucionar sus entornos ERP.
Podemos ayudarte con tareas de:
- Administración de Dynamics NAV.
- Configuración de servidores e instancias.
- Gestión de usuarios y permisos.
- Migración de Dynamics NAV a Business Central.
- Desarrollo y personalización.
- Soporte técnico.
- Optimización y mantenimiento del entorno.
Si necesitas ayuda para administrar tu entorno Dynamics NAV o estás planteándote migrar a Business Central, contacta con ABD y estudiaremos contigo la mejor opción.