Agent

Informations sur les agents PowerShell Universal.

Les agents PowerShell Universal fournissent un mécanisme permettant d'exécuter des scripts sur des machines distantes sans avoir à configurer PowerShell Remoting. Les agents sont des services légers qui hébergent le SDK PowerShell et se connectent à PowerShell Universal via WebSockets.

Vous pouvez apprendre à envoyer des commandes aux agents sur la page Event Hubs.

Installation

Vous pouvez en apprendre davantage sur l'installation de l'agent sur notre page d'installation.

agent.json

Après avoir installé l'agent, vous devrez configurer le client à l'aide d'un fichier agent.json. Si le fichier n'existe pas, vous devrez le créer.

Ce fichier JSON configure l'agent pour se connecter au hub et exécuter des scripts lorsqu'il est invoqué.

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

Emplacement

Système

L'emplacement système du fichier agent.json se trouve dans $ENV:ProgramData\PowerShellUniversal.

Utilisateur

L'emplacement spécifique à l'utilisateur du fichier agent.json se trouve dans $ENV:AppData\PowerShellUniversal.

Options

Les options ci-dessous peuvent être incluses dans le fichier agent.json.

Connexions

Il s'agit des connexions aux Event Hubs. Chaque connexion peut contenir sa propre URL, son hub, son authentification et le script à exécuter.

URL (obligatoire)

L'URL du service PowerShell Universal.

Hub (obligatoire)

Le nom de l'Event Hub.

AppToken

Le jeton d'application utilisé pour s'authentifier auprès du hub.

UseDefaultCredentials

L'authentification Windows sera utilisée pour s'authentifier auprès du hub.

ScriptPath

Le script à exécuter lorsqu'un événement est reçu. Ce script est lu en mémoire et non depuis le disque. Les variables telles que $PSScriptRoot ne sont actuellement pas prises en charge. Cette option est facultative, car les event hubs peuvent également exécuter des commandes directement.

Si ScriptPath est un chemin relatif tel que script.ps1, l'agent le résout par rapport au répertoire de données PowerShell Universal. Sous Windows, cela correspond à %ProgramData%\PowerShellUniversal\script.ps1, sauf si vous fournissez un chemin complet.

Description

La description de cette connexion. Elle sera transmise au serveur PowerShell Universal.

Variables d'environnement

Les variables d'environnement peuvent être utilisées pour configurer divers paramètres opérationnels de l'agent.

Nom	Description	Valeur par défaut
PSU_AgentLogLevel	Définit le niveau de journalisation du service agent.	Information
PSU_Connections__0__Url	L'URL du service PowerShell Universal.
PSU_Connections__0__Hub	Le nom de l'Event Hub auquel se connecter.
PSU_Connections__0__AppToken	Le jeton d'application utilisé pour se connecter à un hub authentifié.