aardio 可以方便地调用 PowerShell ，PowerShell 中也可以自由调用 aardio 对象与函数。不用带上体积很大的
System.Management.Automation.dll，直接调用系统组件，可以生成体积很小的独立 EXE。向下兼容到 .NET 2.0、PowerShell 2.0，支持 Win7，Win8，Win10，Win11 ……
▶ dotNet.ps 扩展库
aardio 调用 PowerShelll 的功能由基于 dotNet 库 实现的 dotNet.ps 库提供。请参考：aardio + .NET 快速开发独立 EXE 程序，可防 ILSpy 反编译 。
▶ aardio 调用 PowerShell 命令
我们直接上代码看示例：
import console; import dotNet.ps; console.showLoading(" 正在执行PowerShell命令"); console.log( dotNet.ps.command("Get-Command",{"ListImported"}) ); console.pause();
dotNet.ps.command 的第一个参数指定要调用的 PowerShell 命令名，第二个参数用一个表对象指定 PowerShell 命令参数 —— 可以包含仅由参数名字组成的数组成员。
参数表也可以包含由名值对指定的命名参数，例如：
dotNet.ps.command("Get-Command" ,{Name="*Process"} );
要注意参数名前面不需要加 $ 或 - 前缀。
等号前面是参数名（必须是字符串），等号后面是参数值（可传入 .NET 对象、COM 对象、aardio 对象）。
▶ aardio 调用 PowerShell 脚本
使用匿名参数调用 PowerShell 脚本的示例：
var ps1 = /* for ( $i=0; $i -lt $args.count; $i++){ write-host $args[$i] } */ import dotNet.ps; var output = dotNet.ps(ps1,{ "匿名参数1","匿名参数2","匿名参数3","匿名参数4" }); import console; console.log(output); console.pause();
匿名参数也可以这样写：
dotNet.ps(ps1,"匿名参数1","匿名参数2","匿名参数3","匿名参数4");
也可以指定命名参数，如下：
var ps1 = /* # 定义命名参数，参数前加$号，aardio 参数表里去掉$号 param($username,$password) Write-host $username,$password */ import dotNet.ps; var output = dotNet.ps(ps1,{ username = "名字";//参数名前不要加$ password = "密码";//参数名前不要加$ }); import console; console.log(output); console.pause();
这里请注意：
1、PowerShell 通常用 param 声明参数名称（函数里也可以这样写）。
2、PowerShell 要在变量（或参数名）前加上 $ 符号，在 aardio 中指定 PowerShell 参数时要去掉这个 $ 符号。
dotNet.ps() ， dotNet.ps.command() 的传参数规则是完全一样的。
▶ PowerShell 调用 aardio 对象
下面就要进入最神奇的部分了，在 PowerShell 里还可以方便地调用 aardio 对象。
我们直接看 aardio 代码示例：
var ps1 = /* # 定义命名参数 param($win,$external,$username) # 自由调用参数传进来的 aardio 对象 $win.msgboxTest("这是 PowerShell 调用 aardio 打开的对话框。") #返回值会自动输出一行 # 自由调用 aardio 函数 $external.func("参数1","参数2") */ import win; import dotNet.ps; var output = dotNet.ps(ps1,{ win = win; external = { func = function(title,text){ win.msgbox(text,title) } }; });
Win10 / Win11 自带的 PowerShell 5.1 可以支持这种舒服的写法。如果要兼容 Win7 只要简单地调用 dotNet.ps.export( aardio对象 ) 导出参数给 PowerShell 就可以了，不过 Win7 的市场份额已经很小，这种事太追求完美也不好。
▶ 用 JSON 解析 PowerShell 输出
aardio 代码示例：
import console; import dotNet.ps; var psVersion = dotNet.ps.json( `ConvertTo-Json $PSVersionTable.PSVersion`) console.dumpJson(psVersion); console.pause(true);
▶ 捕获 PowerShell 输出
很简单，我们直接看 aardio 代码示例：
import console; import dotNet.ps; // PowerShell 输入都会传给这个 aardio 函数 dotNet.ps.onWrite = function(str){ console.log(str); } dotNet.ps.command("Get-Command",{Name="*Process"}); console.pause(output);
我们也可以指定 dotNet.ps.onWriteProgress 回调以自定义 PowerShell 进度条，一个例子：
这个进度条范例的源码在这里：
aardio 自带范例 / 调用其他语言 / PowerShell / 进度条
上面范例里有一些方便的小工具，例如操作系统默认禁止单独运行 *.ps1 脚本文件。上面范例里就提供了一个小工具 —— 可以一键开启或关闭这个权限：
PowerShell 里有很多 Cmdlet 是用 C# 写的，而 C# 写的软件可以用 ILSpy 直接查看源码。其实看看一些 Cmdlet 的源码很有意思，但这个操作步骤有些多。
aardio 自带的 PowerShell 范例里还提供了一个快速查看 Cmdlet 源码的工具，可以直接列出所有命令，可以搜索查询，可以一键调用 ILSpy 反编译出源代码：
▶ aardio / PowerShell / .NET 共享应用程序域
用大白话讲就是这三者可以直接共享对象，相互调用对象非常方便。
当使用 dotNet.ps 运行 PowerShell 代码是在当前进程中运行（ 没有创建新进程，但创建了新线程），并且 PowerShell 就运行在 aardio 创建的 .NET 应用程序域中 —— 这时候 aardio / PowerShell / .NET 共享一个应用程序域，这让我们可以做一些有趣的事。
请看 aardio 代码示例：
import dotNet.ps; import dotNet.json; var json = dotNet.ps( ` # 哈希表(数组元素要用逗号分开) $tab = @{ Name = "张三"; Age = "20"; Array = 1,2,3 } # PowerShell 类型放在 [] 里面，并用 :: 访问类的静态成员 [Newtonsoft.Json.JsonConvert]::SerializeObject( $tab ) ` ); var tab = web.json.parse(json); import console console.dump(tab) console.pause()
aardio 库 dotNet.json 内存加载了 .NET 程序集 Newtonsoft.Json.dll，然后我们在 .NET 或是 PowerShell 中就可以直接使用这个程序集导入的类。
注意：PowerShell 将类或类型放在 [中括号] 内，PowerShell 在声明或强制转换类型时都使用这个 [中括号] ，访问类的静态成员使用 :: 而不是圆点 。
下面的例子更进一步：在 aardio 中编译 C# 代码，然后在 PowerShell 中调用该 C# 代码引入的类，然后在 C# 中回调 PowerShell 函数，然后在该 PowerShell 函数中回调 aardio 函数：
import win; import console; import dotNet.ps; var compiler = dotNet.createCompiler("C#"); compiler.Source = /****** namespace CSharpLibrary { public class Object { public delegate int TestDelegateType(string str,int a); public event TestDelegateType onTestEvent; public int Test() { return onTestEvent("你好",123); } public static Object New(){return new Object(); } } } ******/ //编译 C# 代码并导入名字空间 compiler.import("CSharpLibrary"); var out,err = dotNet.ps( ` param($win) $obj = [CSharpLibrary.Object]::New() #创建对象 # 添加事件 $obj.add_onTestEvent( { param($str,$a) # 声明参数 # 调用 aardio 函数 $temp = $win.msgbox("事件被回调了",$str) # return 语句只能改最后一个返回值，与其他语言有较大区别 return $a }) $obj.Test() `,{ win = win; }); console.log(out,err); console.pause(true);
这里就要注意 PowerShell 有一个非常特别的『 特（大）性（坑）』—— PowerShell 的函数里每句代码的默认输入都会增加一个返回值，例如您执行下面的 PowerShell 代码：
# 添加事件 $obj.add_onTestEvent( { param($str,$a) $win.msgbox("事件被回调了",$str) return $a })
这里的返回值实际上有两个，一个是 $win.msgbox() 返回的 object，另一个是 return 返回的 $a，最终返回值是一个数组。然后就会报返回值与 C# 委托回调的返回值类型不匹配。
避免上面这个问题也很简单，把代码放到一个赋值语句里就不会增加返回值了，正确写法：
$temp = $win.msgbox("事件被回调了",$str)
▶ 创建管道调用 PowerShell.exe
我们还可以用 aardio 中的 procee.popen 创建进程管道，这样就可以读写 PowerShell.exe 的输出输入，并且隐藏黑窗口。
下面是一个例子：
import console; import process.popen; console.showLoading(" 请稍候，正在调用 PowerShell"); var prcs = process.popen.ps(`-Command`,`&{ function Get-Version { ConvertTo-Json( $PSVersionTable.PSVersion ) } Get-Version }`); //读取进程输出 var json = prcs.readAll(); //解析返回的 JSON import web.json; var psVersion = web.json.parse(json); console.dump(psVersion); console.pause();
这里要注意，PowerShell 会将仅用大括号包含的 PowerShell 作为字符串输出，在前面加上一个 & 字符才会执行该语句块。
▶ 调用更多编程语言
aardio 中还可以非常方便地调用 C语言、C++、C#、Java、Python、R、Javascript、Node.Js、Fortran、VB、Flash ActionScript、PHP、VBScript、PowerShell、NewLISP、AutoLISP、Delphi、FreeBASIC、Ruby、Rust、Julia、Nim、Go 语言、批处理 ...... 甚至可以直接嵌入汇编机器码并且转换为普通的 aardio 函数。
