PowerShell-Host

PowerShell-Host is a JavaScript library which hosts a PowerShell process to allow running commands and getting the results back quickly. PowerShell Exceptions are intercepted and the Message property is emitted to stderr.

This implementation uses Promises to make things easy to use:

• Output on stderr will be rejected.
• Output on stdout will be resolved.

Example:

You can use the in-built ConvertTo-Json applet to make parsing the data easy.

1import { PowerShell } from 'powershell-host';
2
3const ps = new PowerShell();
4
5const run = async () => {
6    // Open a new PowerShell without any profile which might impede us
7    await ps.open({ args: ['-NoProfile'] });
8
9    // Log any errors that might occur after opening
10    // such as invalid arguments in the open command above
11    ps.on('error', (err) => {
12        console.log(`ERROR: ${err}`);
13    });
14
15    // Log if shell exits for any reason
16    ps.on('exit', (code, signal) => {
17        // Will not log graceful exit we removed all listeners on close
18        console.log(`shell exited code:${code} signal: ${signal}`);
19    });
20
21    const json = await ps.exec('Get-PsDrive | Select Name, Root | ConvertTo-Json');
22    const obj = JSON.parse(json);
23    // Newer versions of PowerShell can use ConvertTo-Json -ToArray to avoid forcing an array here
24    const result = Array.isArray(obj) ? obj : [obj];
25    result.forEach((drive) => console.log(drive.Name));
26};
27
28run()
29    .catch((err) => {
30        console.error(`ERROR: ${err.message}`);
31    })
32    .finally(() => {
33        ps.close();
34        ps.removeAllListeners();
35    });