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.
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.
Última actualización
¿Te fue útil?