Agent

Gli agent di PowerShell Universal forniscono un meccanismo per eseguire script su computer remoti senza dover configurare PowerShell Remoting. Gli agent sono servizi leggeri che ospitano l'SDK di PowerShell e si connettono a PowerShell Universal utilizzando i WebSocket.

Può scoprire come inviare comandi agli agent nella pagina Event Hubs.

Installazione

Può trovare maggiori informazioni sull'installazione dell'agent nella nostra pagina di installazione.

agent.json

Dopo aver installato l'agent, dovrà configurare il client utilizzando un file agent.json. Se il file non esiste, dovrà crearlo.

Questo file JSON configura l'agent affinché si connetta all'hub ed esegua gli script quando viene richiamato.

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

Posizione

Sistema

La posizione di sistema di agent.json è in $ENV:ProgramData\PowerShellUniversal.

Utente

La posizione specifica dell'utente di agent.json è in $ENV:AppData\PowerShellUniversal.

Opzioni

Le opzioni seguenti possono essere incluse nel file agent.json.

Connections

Queste sono le connessioni agli Event Hub. Ogni connessione può contenere il proprio URL, hub, autenticazione e script da eseguire.

URL (obbligatorio)

L'URL del servizio PowerShell Universal.

Hub (obbligatorio)

Il nome dell'Event Hub.

AppToken

Il token dell'app utilizzato per l'autenticazione presso l'hub.

UseDefaultCredentials

Per l'autenticazione presso l'hub verrà utilizzata l'autenticazione di Windows.

ScriptPath

Lo script da eseguire quando viene ricevuto un evento. Questo script viene letto in memoria e non da disco. Variabili come $PSScriptRoot non sono attualmente supportate. Questo è facoltativo, poiché gli event hub possono anche eseguire comandi direttamente.

Se ScriptPath è un percorso relativo come script.ps1, l'agent lo risolve relativamente alla directory dei dati di PowerShell Universal. Su Windows, ciò significa %ProgramData%\PowerShellUniversal\script.ps1, a meno che non fornisca un percorso completo.

Description

La descrizione di questa connessione. Verrà segnalata al server PowerShell Universal.

Variabili d'ambiente

Le variabili d'ambiente possono essere utilizzate per configurare varie impostazioni operative dell'agent.

Nome	Descrizione	Valore predefinito
PSU_AgentLogLevel	Imposta il livello di log per il servizio agent.	Information
PSU_Connections__0__Url	L'URL del servizio PowerShell Universal.
PSU_Connections__0__Hub	Il nome dell'Event Hub a cui connettersi.
PSU_Connections__0__AppToken	Il token dell'app utilizzato per connettersi a un hub autenticato.