API di gestione

È possibile gestire PowerShell Universal utilizzando la Management API integrata. Consente di eseguire tutte le azioni della console di amministrazione in modo automatizzato. È possibile visualizzare e testare l'API visitando la documentazione Swagger dell'API nella sua posizione predefinita sulla macchina http://localhost:5000/swagger/index.html .

La Management API è integrata e non richiede una licenza per Universal API.

Modulo PowerShell

Forniamo un modulo PowerShell che chiama l'API per suo conto, così non dovrà scrivere lei stesso le richieste HTTP. Può scaricare questo modulo dalla PowerShell Gallery.

Install-Module Universal

Il modulo PowerShell richiede un app token e il nome del computer per chiamare il server Universal. È possibile fornire questi elementi a ogni chiamata.

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

Inoltre, è possibile connettersi al server Universal utilizzando Connect-UAServer.

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

API REST

È possibile accedere alla Management API di PowerShell Universal tramite chiamate REST. È possibile visualizzare le chiamate disponibili utilizzando la documentazione Swagger dell'API integrata. Sarà necessario un App Token per effettuare chiamate all'API REST.

App Token

Gli App Token sono richiesti dalla Management API. Dovrà utilizzare un App Token sia con i cmdlet PowerShell sia per chiamare direttamente la Management API tramite REST.

È possibile utilizzare un App Token con Invoke-RestMethod specificando l'intestazione di autorizzazione.

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