API de gestion

Vous pouvez gérer PowerShell Universal à l'aide de l'API de gestion intégrée. Elle offre la possibilité 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 à son emplacement par défaut sur votre machine http://localhost:5000/swagger/index.html.

L'API de gestion 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 la PowerShell Gallery.

Install-Module Universal

Le module PowerShell nécessite un jeton d'application 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 en utilisant Connect-UAServer.

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

REST API

L'API de gestion de PowerShell Universal est accessible via des appels REST. Vous pouvez consulter les appels disponibles à l'aide de la documentation Swagger intégrée. Vous aurez besoin d'un jeton d'application pour effectuer des appels vers l'API REST.

Jetons d'application

Les jetons d'application sont requis par l'API de gestion. Vous devrez utiliser un jeton d'application aussi bien avec les cmdlets PowerShell que pour appeler l'API de gestion directement via REST.

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

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