Agente

Los PowerShell Universal Agents proporcionan un mecanismo para ejecutar scripts en máquinas remotas sin tener que configurar PowerShell Remoting. Los agentes son servicios ligeros que alojan el SDK de PowerShell y se conectan a PowerShell Universal mediante WebSockets.

Puede aprender a enviar comandos a los agentes en la página Event Hubs.

Instalación

Puede obtener más información sobre la instalación del agente en nuestra página de instalación.

agent.json

Después de instalar el agente, deberá configurar el cliente mediante un fichero agent.json. Si el fichero no existe, deberá crearlo.

Este fichero JSON configura el Agent para conectarse al hub y ejecutar scripts cuando se le invoque.

{
    "Connections": [
        {
            "Url": "http://localhost:5000",
            "Hub": "eventHub",
            "AppToken": "tokenXyz",
            "ScriptPath": "script.ps1",
            "Description": "My agent"
        }
    ]
}

Ubicación

Sistema

La ubicación de sistema de agent.json es $ENV:ProgramData\PowerShellUniversal.

Usuario

La ubicación específica del usuario de agent.json es $ENV:AppData\PowerShellUniversal.

Opciones

Las siguientes opciones se pueden incluir en el fichero agent.json.

Conexiones

Estas son las conexiones a los Event Hubs. Cada conexión puede contener su propia URL, hub, autenticación y script a ejecutar.

URL (obligatorio)

La URL del servicio PowerShell Universal.

Hub (obligatorio)

El nombre del Event Hub.

AppToken

El token de aplicación utilizado para autenticarse contra el hub.

UseDefaultCredentials

Se utilizará la autenticación de Windows para autenticarse contra el hub.

ScriptPath

El script a ejecutar cuando se recibe un evento. Este script se lee en memoria y no desde el disco. Variables como $PSScriptRoot no son compatibles actualmente. Esto es opcional, ya que los event hubs también pueden ejecutar comandos directamente.

Si ScriptPath es una ruta relativa como script.ps1, el agente la resuelve en relación con el directorio de datos de PowerShell Universal. En Windows, eso significa %ProgramData%\PowerShellUniversal\script.ps1 a menos que proporcione una ruta completamente cualificada.

Descripción

La descripción de esta conexión. Se comunicará al servidor de PowerShell Universal.

Variables de entorno

Las variables de entorno se pueden utilizar para configurar diversos ajustes operativos del agente.

Nombre	Descripción	Valor predeterminado
PSU_AgentLogLevel	Establece el nivel de registro del servicio del agente.	Information
PSU_Connections__0__Url	La URL del servicio PowerShell Universal.
PSU_Connections__0__Hub	El nombre del Event Hub al que conectarse.
PSU_Connections__0__AppToken	El token de aplicación utilizado para conectarse a un hub autenticado.