API de gestion

Vous pouvez gérer PowerShell Universal à l'aide de la Management API intégrée. Elle permet d'effectuer toutes les actions de la console d'administration de manière automatisée. Vous pouvez consulter et tester l'API en visitant la documentation Swagger API à son emplacement par défaut sur votre machine http://localhost:5000/swagger/index.html .

La Management API est intégrée et ne nécessite pas de licence pour Universal API.

Module PowerShell

Nous fournissons un module PowerShell qui appelle l'API en votre nom afin que vous n'ayez pas à écrire les requêtes HTTP vous-même. Vous pouvez télécharger ce module depuis le PowerShell Gallery.

Install-Module Universal

Le module PowerShell nécessite un jeton d'appli et un nom d'ordinateur pour appeler le serveur Universal. Vous pouvez fournir ces éléments à chaque appel.

Invoke-PSUScript -Script $Script -ComputerName http://localhost:5000 -AppToken $AppToken

De plus, vous pouvez vous connecter au serveur Universal à l'aide de Connect-UAServer.

Connect-PSUServer -ComputerName http://localhost:5000 -AppToken $AppToken

REST API

La Management API de PowerShell Universal est accessible au moyen d'appels REST. Vous pouvez consulter les appels disponibles à l'aide de la documentation Swagger API intégrée. Vous aurez besoin d'un App Token pour effectuer des appels vers la REST API.

App Tokens

Les App Tokens sont requis par la Management API. Vous devrez utiliser un App Token avec les applets de commande PowerShell ainsi que pour appeler la Management API directement au moyen de REST.

Vous pouvez utiliser un App Token avec Invoke-RestMethod en spécifiant l'en-tête d'autorisation.

Invoke-RestMethod http://localhost:5000/api/v1/script -Headers @{ Authorization = "Bearer appToken" }