# Windows Powershell script runner
This crate is pretty basic. It uses `std::process::Command` to pipe commands
to PowerShell. In addition to that there is a convenient wrapper around `process::Output`
especially tailored towards the usecase of running Windows PowerShell commands.
## Usage
I recommend that you write the commands to a `*.ps` file to be able to take advantage
of existing tools to create the script.
This example creates a shortcut of `notepad.exe` to the desktop.
_NB. If you use OneDrive chances are that your desktop is located at "$env:UserProfile\OneDrive\Desktop\notepad.lnk" instead._
**In `script.ps`**
```ps
$SourceFileLocation="C:\Windows\notepad.exe"
$ShortcutLocation="$env:UserProfile\Desktop\notepad.lnk"
$WScriptShell=New-Object -ComObject WScript.Shell
$Shortcut=$WScriptShell.CreateShortcut($ShortcutLocation)
$Shortcut.TargetPath=$SourceFileLocation
$Shortcut.Save()
```
**In `main.rs`**
```rust
extern crate powershell_script;
use std::io::{stdin, Read};
/// Creates a shortcut to notpad on the desktop
fn main() {
let create_shortcut = include_str!("script.ps");
match powershell_script::run(create_shortcut, true) {
Ok(output) => {
println!("{}", output);
}
Err(e) => {
println!("Error: {}", e);
}
}
}
```
You can of course provide the commands as a string literal instead. Just beware that
we run each `line` as a separate command.
## Compatability
This is only tested on Windows and most likely will only work on Windows. It should
be possible to support PowerShell Core on Linux with only minor adjustments so leave
a feature request if there is any interest in that.
## Contributing
Right now this is only meant as a convenient wrapper for running PowerShell scripts,
and I've been thinking about creating a `utils` crate with common tasks on Windows
like creating a shortcut to a file (symlinking requires administrative privileges)
but that will be better off in a separate create so this can focus on running scripts.
Any pull requests with bugfixes or efficiency improvements is greatly appreciated.