Repositorio

Los datos de configuración de PowerShell Universal se almacenan principalmente en el repositorio. De forma predeterminada, la carpeta del repositorio se encuentra en %ProgramData%\UniversalAutomation\Repository. Puede ajustar la ubicación del repositorio editando el fichero appsettings.json.

El repositorio contiene scripts de PowerShell y ficheros XML que se generan al utilizar la consola de administración de PowerShell Universal. También se supervisan los cambios en la carpeta del repositorio, por lo que cualquier cambio realizado en el disco hará que el sistema vuelva a cargar el fichero y reconfigure la plataforma. Cuando se utiliza la integración con Git, la carpeta del repositorio es la que se sincroniza con el remoto de git.

Todos los cmdlets de configuración forman parte del módulo Universal.

Qué se almacena en el repositorio

Los ficheros almacenados en el repositorio se guardan como texto sin formato para facilitar la comparación de diferencias con las herramientas de control de código fuente.

• Autenticación
• Agentes y herramientas de IA
• Aplicaciones
• Endpoints
• Entornos
• Licencias
• Páginas de inicio de sesión
• Páginas
• Carpetas publicadas
• Límites de frecuencia
• Roles
• Programaciones
• Scripts
• Configuración
• Etiquetas
• Desencadenadores
• Bóvedas

Qué no se almacena en el repositorio

Estas entidades se almacenan en la base de datos de PowerShell Universal.

• Tokens de aplicación
• Identidades
• Historial de trabajos

Edición del repositorio

Puede editar los ficheros del repositorio directamente en la consola de administración navegando a Configuración \ Ficheros. El editor le permite crear ficheros y carpetas y editar cualquier fichero dentro del directorio del repositorio.

También puede editar el repositorio directamente en el disco utilizando editores como Visual Studio Code. De forma predeterminada, los ficheros se almacenan en %ProgramData%\UniversalAutomation\Repository. Deberá habilitar la recarga automática o resolver los cambios manualmente. Puede ver los ficheros modificados navegando a Configuración \ Ficheros \ Seguimiento de configuración.

Scripts de configuración

Authentication.ps1

Almacenado en .universal\authentication.ps1

Este script se encarga de configurar la autenticación por formularios. Si no se utiliza la autenticación por formularios, este fichero se ignora.

Puede utilizar el cmdlet Set-PSUAuthentication en este fichero.

AiAgents.ps1

Almacenado en .universal\aiAgents.ps1

Este script se encarga de configurar los agentes de IA. Utilice el cmdlet New-PSUAIAgents en este fichero.

AiTools.ps1

Almacenado en .universal\aiTools.ps1

Este script se encarga de configurar las herramientas de IA. Utilice el cmdlet New-PSUAITool en este fichero.

Branding.ps1

Almacenado en .universal\branding.ps1

Este script se encarga de configurar los ajustes de marca.

Puede utilizar el cmdlet New-PSUBranding en este fichero.

Dashboards.ps1

Almacenado en .universal\dashboards.ps1

Este script se encarga de registrar los ficheros PS1 como aplicaciones dentro del sistema. Cada comando contiene los metadatos de la aplicación, incluidos el nombre, la URL base y el entorno.

Puede utilizar el cmdlet New-PSUApp en este fichero.

Endpoints.ps1

Almacenado en .universal\endpoints.ps1

Este script se encarga de definir todos los endpoints de API de la instancia de PowerShell Universal.

Puede utilizar el cmdlet New-PSUEndpoint en este fichero.

Environments.ps1

Almacenado en .universal\environments.ps1

Este script se encarga de definir todos los entornos dentro de PowerShell Universal.

Puede utilizar el cmdlet New-PSUEnvironment en este fichero.

healthChecks.ps1

Almacenado en .universal\healthChecks.ps1

Este script se encarga de definir las comprobaciones de estado dentro de PowerShell Universal.

Puede utilizar el cmdlet New-PSUHealthCheck en este fichero.

Licenses.ps1

Almacenado en .universal\licenses.ps1

Este script se encarga de definir la licencia utilizada en PowerShell Universal.

Puede utilizar el cmdlet Set-PSULicense en este fichero.

Set-PSULicense -Key "<License></License>"

Initialize.ps1

Almacenado en .universal\initialize.ps1

Este script se ejecuta antes de que se realice cualquier configuración en PowerShell Universal. El servidor está en ejecución, pero ninguno de los servicios se ha iniciado. Esto resulta útil para instalar módulos o configurar bóvedas de secretos antes de que se inicie la detección de esos recursos.

Middleware.ps1

Almacenado en .universal\middleware.ps1

Permite personalizar las solicitudes HTTP en PowerShell Universal.

PublishedFolders.ps1

Almacenado en .universal\publishedFolders.ps1

Este script se encarga de configurar las carpetas publicadas.

Puede utilizar el cmdlet New-PSUPublishedFolder en este fichero.

RateLimits.ps1

Almacenado en .universal\rateLimits.ps1

Este script se encarga de configurar los límites de frecuencia.

Puede utilizar el cmdlet New-PSURateLimit en este fichero.

Roles.ps1

Almacenado en .universal\roles.ps1

Este script se encarga de configurar los roles.

Puede utilizar el cmdlet New-PSURole en este fichero.

Schedules.ps1

Almacenado en .universal\schedules.ps1

Este script se encarga de configurar las programaciones.

Puede utilizar el cmdlet New-PSUSchedule en este fichero.

Scripts.ps1

Almacenado en .universal\scripts.ps1

Este script contiene los metadatos de los scripts. Los scripts reales pueden almacenarse en cualquier ubicación. La ruta que se incluye es relativa al repositorio. También se permiten nombres de ruta completos.

Puede utilizar el cmdlet New-PSUScript en este fichero.

Settings.ps1

Almacenado en .universal\settings.ps1

Este script se encarga de definir la configuración del sistema.

Puede utilizar el cmdlet Set-PSUSetting en este fichero.

Tags.ps1

Almacenado en .universal\tags.ps1

Este script se encarga de configurar las etiquetas.

Puede utilizar el cmdlet New-PSUTag en este fichero.

Triggers.ps1

Almacenado en .universal\triggers.ps1

Este script se encarga de configurar los desencadenadores.

Puede utilizar el cmdlet New-PSUTrigger en este fichero.

Variables.ps1

Almacenado en .universal\variables.ps1

Este script se encarga de configurar las variables.

Puede utilizar el cmdlet New-PSUVariable en este fichero.

Vaults.ps1

Almacenado en .universal\vaults.ps1

Este script se encarga de configurar las bóvedas.

Plantillas

Mediante la carpeta Templates del repositorio, puede crear una selección de plantillas de elementos para las funciones más utilizadas en PowerShell Universal. Esto incluye aplicaciones, páginas de aplicación, scripts y endpoints.

Plantilla de script

Los ficheros PS1 de las siguientes carpetas se ofrecerán como plantillas en la consola de administración.

• Templates \ App
• Templates \ AppPage
• Templates \ Endpoint
• Templates \ Script

.psuignore

El fichero .psuignore se puede usar para excluir determinados ficheros o patrones del observador del sistema de ficheros en PowerShell Universal. Esto resulta útil al guardar ficheros como registros en el directorio del repositorio. El formato del fichero debe ser una única expresión regular por línea. Si la expresión regular coincide con una ruta, el sistema de configuración la ignorará.

logs.*
.git.*

Codificación de ficheros

Puede configurar la codificación de ficheros en la página Configuración \ General. De forma predeterminada, PowerShell Universal usará UTF-8 con una marca de orden de bytes (utf-8-bom) al principio del fichero. Si desea desactivar la marca de orden de bytes, puede cambiar la codificación a utf-8.

Las codificaciones admitidas son cualquiera de las devueltas por Encoding.GetEncodings. Por ejemplo:

• utf-32
• utf-32-bom
• utf-8
• utf-8-bom
• windows-1250

Puede añadir -bom al final de la codificación para añadir la marca de orden de bytes.

Secciones de configuración de solo lectura

Las secciones de solo lectura le permiten incluir script en sus ficheros de configuración que no se verán afectados por los cambios en la consola de administración. Esto le permite ejecutar lógica adicional, generar recursos de forma dinámica y crear clases para usarlas en esquemas de OpenAPI.

La región PSUHeader se coloca en la parte superior de su script. PSUFooter se coloca en la parte inferior.

#region PSUHeader 

1..100 | ForEach-Object {
    New-PSUEndpoint -Url "/endpoint/$_" -Endpoint {

    }
}

#endregion

New-PSUEndpoint -Url "/user" -Endpoint {

}

#region PSUFooter
#endregion

Recursos de base de datos

Opcionalmente, puede configurar los recursos para que se almacenen en la base de datos en lugar de en el repositorio de configuración. Estos recursos ya no se almacenarán en disco, sino directamente en la base de datos. Esto los hace disponibles al instante para permitir los ordenadores conectados en el clúster de PSU.

Cuando se configura, los ficheros de configuración de los recursos se ignorarán.

Algunos recursos no son compatibles. Entre ellos se incluyen:

• Aplicaciones
• Endpoints con rutas
• Scripts
• Módulos

Para configurar un recurso para su persistencia en la base de datos, debe configurar los App Settings para cada tipo de clase. A continuación se muestra un ejemplo de almacenamiento de programaciones en la base de datos.

{
    "Data": {
        "Persistence" : {
            "Schedule": "Database",
            "ScheduleParameter": "Database"
        }
    }
}