PowerShell，按需Internet的自动负载功能

Question

它向我指出（在 powerShell，复制bash Parallel ping ），我可以从Internet上加载一个函数，如下所示

iex (irm https://raw.githubusercontent.com/proxb/AsyncFunctions/master/Test-ConnectionAsync.ps1)

： URL引用 test-connectionAsync.ps1 包含两个函数： ping-subnet 和 test-connectionAseNAsync

这让我想知道我是否可以定义旁路功能在我的个人模块中，它是虚拟函数，一旦被调用，它们就会永久覆盖。例如，

function Ping-Subnet <mimic the switches of the function to be loaded> {
    if <function is not already loaded from internet> {
        iex (irm https://raw.githubusercontent.com/proxb/AsyncFunctions/master/Test-ConnectionAsync.ps1)
    }
    # Now, somehow, permanently overwrite Ping-Subnet to be the function that loaded from the URL
    Ping-Subnet <pass the switches that we mimicked to the required function that we have just loaded>
}

这将非常简单地允许我直接从我的模块引用许多有用的脚本，但是无需在加载模块时必须从Internet上加载它们（即仅按需加载功能，我调用它们，除非我需要它们，否则我通常永远不会调用这些功能）。

Answer 1

您可以使用解析器在远程脚本中找到功能并将其加载到您的范围中。这不会是自我升级功能，但应该比您想完成的工作更安全。

using namespace System.Management.Automation.Language

function Load-Function {
    [cmdletbinding()]
    param(
        [parameter(Mandatory, ValueFromPipeline)]
        [uri] $URI
    )

    process {
        try {
            $funcs = Invoke-RestMethod $URI
            $ast = [Parser]::ParseInput($funcs, [ref] $null, [ref] $null)
            foreach($func in $ast.FindAll({ $args[0] -is [FunctionDefinitionAst] }, $true)) {
                if($func.Name -in (Get-Command -CommandType Function).Name) {
                    Write-Warning "$($func.Name) is already loaded! Skipping"
                    continue
                }
                New-Item -Name "script:$($func.Name)" -Path function: -Value $func.Body.GetScriptBlock()
            }
        }
        catch {
            Write-Warning $_.Exception.Message
        }
    }
}

Load-Function https://raw.githubusercontent.com/proxb/AsyncFunctions/master/Test-ConnectionAsync.ps1
Ping-Subnet # => now is available in your current session.

Answer 2

function Ping-Subnet{
    $toImport = (IRM "https://raw.githubusercontent.com/proxb/AsyncFunctions/master/Test-ConnectionAsync.ps1").
                Replace([Text.Encoding]::UTF8.GetString((239,187,191)),"")
    NMO([ScriptBlock]::Create($toImport))|Out-Null
    $MyInvocation.Line|IEX
}
function Test-ConnectionAsync{
    $toImport = (IRM "https://raw.githubusercontent.com/proxb/AsyncFunctions/master/Test-ConnectionAsync.ps1").
                Replace([Text.Encoding]::UTF8.GetString((239,187,191)),"")
    NMO([ScriptBlock]::Create($toImport))|Out-Null
    $MyInvocation.Line|IEX
}

Ping-Subnet -Result Success

Test-ConnectionAsync -Computername $env:COMPUTERNAME

结果：

Computername   Result
------------   ------
192.168.1.1   Success
192.168.1.2   Success
192.168.1.146 Success

Computername IPAddress                  Result
------------ ---------                  ------
HOME-PC      fe80::123:1234:ABCD:EF12  Success

Answer 3

是的，它应该起作用。调用 test-connectionAsync.ps1 在一个函数中，将在包装函数的范围中创建定义的函数。您将能够调用任何包装功能，直到功能的范围结束为止。

如果您将包装器命名和包装功能不同，则可以检查是否已使用类似...

否则，您需要获得更多的创意。

也就是说， 继续谨慎 。像这样，远程代码执行充满了安全问题，尤其是在我们谈论的方式中，没有验证 test-connectionAsenc.ps1 。

Answer 4

fors1k的答案值得获得信用，因为提出了该方法的巧妙基础< /strong>：

• 在用
  Dynamic Module 中下载并执行远程脚本的内容。脚本的功能将被自动出口并获得 session-globally ^[1]

  
  

  
  

  • 请注意，动态模块并不容易发现，因为它们没有在
    get-module 的输出;但是，您可以通过 .source 属性。 powershell/module/microsoft.powershell.core/get-command“ rel =“ nofollow noreferrer”> get-command ：

      get-command | source -like __dynamicModule_*
     

  • 如果您尝试在不应影响会话的全局状态的脚本中使用该技术，则下载的函数可用 session -globally 可能是不希望的 - 请参阅底部解决方案的部分。

• 然后重新启用该函数，假设原来的存根函数已被同名下载版本替换，并将收到的参数传递。

虽然Fors1k的解决方案通常会起作用，但这里是一种简化的，可靠的替代方案，可以防止潜在的代码重新执行：

function Ping-Subnet{
  $uri = 'https://raw.githubusercontent.com/proxb/AsyncFunctions/master/Test-ConnectionAsync.ps1'
  # Define and session-globally import a dynamic module based on the remote
  # script's content.
  # Any functions defined in the script would automatically be exported.
  # However, unlike with persisted modules, *aliases* are *not* exported by 
  # default, which the appended Export-ModuleMember call below compensates for.
  # If desired, also add -Variable * in order to export variables too.
  # Conversely, if you only care about functions, remove the Export-ModuleMember call.
  $dynMod = New-Module ([scriptblock]::Create(
    ((Invoke-RestMethod $uri)) + "`nExport-ModuleMember -Function * -Alias *")
  )
  # If this stub function shadows the newly defined function in the dynamic
  # module, remove it first, so that re-invocation by name uses the new function.
  # Note: This happens if this stub function is run in a child scope, such as
  #       in a (non-dot-sourced) script rather than in the global scope.
  #       If run in the global scope, curiously, the stub function seemingly
  #       disappears from view right away - not even Get-Command -All shows it later.
  $myName = $MyInvocation.MyCommand.Name
  if ((Get-Command -Type Function $myName).ModuleName -ne $dynMod.Name) {
    Remove-Item -LiteralPath "function:$myName"
  }
  # Now invoke the newly defined function of the same name, passing the arguments
  # through.
  & $myName @args
}

具体来说，此实现确保了：

• em> Aliases 在远程脚本中定义的

  是导出的。此外（只需删除+“`nexport -modulemember -function * -Alias *'从上面的代码中删除。

• 重新转换鲁棒性针对 new ，模块定义的函数实现 - 即使存根函数在子范围内运行，例如在（非点源）中脚本。

  • 在子范围内运行时， $ myInvocation.line | iex （ iex 是 invoke-expression cmdlet）会导致无限循环，因为当时的存根功能本身仍然有效。

  


  


• 所有收到的参数均在不重新评估的情况下通过重新发电。

  • 使用内置的魔术来剥落自动 $ args variable（@args ）仅通过接收到的已经扩展的参数，支持两者都命名和位置参数。 ^[2]

  • $ myInvocation.line | iex 有两个潜在的问题：

    • 如果调用命令行包含多个命令，则它们是 ash em 重复。

      • 您可以通过替换（get-pscallstack）[1] .position.text $ myInvocation.line 来解决此特定问题下一个问题。

    • 两种 $ myInvocation.line 和（get-pscallstack）[1] .position.text 包含在 em> doducted 中传递的参数/em>（未评估）表格，这会导致其通过 Invoke-Expression 进行重新评估，并且其危险至少在假设上，此重新评估可能涉及冗长的命令，其输出用作其输出为参数或更糟糕的是，具有副作用的命令无法重复或不应该重复。

      
      

    
    

    
    

  
  

  
  

---

将技术范围划分到给定的本地脚本：

如果您尝试在脚本中使用该技术，则下载的功能可用 session-globally 可能是不必要的。 不应该影响会议的全球状态；也就是说，您可能希望在脚本退出时通过动态模块导出的功能消失。

这需要有两个额外的步骤：

• 将动态模块管道到 import-module ，这是能够在使用Remove-Module

• 呼叫 remove-module 带有动态模块，然后退出以卸载。

function Ping-Subnet{
  $uri = 'https://raw.githubusercontent.com/proxb/AsyncFunctions/master/Test-ConnectionAsync.ps1'
  # Save the module in a script-level variable, and pipe it to Import-Module
  # so that it can be removed before the script exits.
  $script:dynMod = New-Module ([scriptblock]::Create(
    ((Invoke-RestMethod $uri)) + "`nExport-ModuleMember -Function * -Alias *")
  ) | Import-Module -PassThru
  # If this stub function shadows the newly defined function in the dynamic
  # module, remove it first, so that re-invocation by name use the new function.
  # Note: This happens if this stub function is run in a child scope, such as
  #       in a (non-dot-sourced) script rather than in the global scope.
  #       If run in the global scope, curiously, the stub function seemingly
  #       disappears from view right away - not even Get-Command -All shows it later.
  $myName = $MyInvocation.MyCommand.Name
  if ((Get-Command -Type Function $myName).ModuleName -ne $dynMod.Name) {
    Remove-Item -LiteralPath "function:$myName"
  }
  # Now invoke the newly defined function of the same name, passing the arguments
  # through.
  & $myName @args
}

# Sample commands to perform in the script.
Ping-Subnet -?
Get-Command Ping-Subnet, Test-ConnectionAsync | Format-Table

# Before exiting, remove (unload) the dynamic module.
$dynMod | Remove-Module

---

^{[1]这假定 new-Module 调用本身是在模块之外进行的；如果在模块中制成，至少该模块的命令会看到自动出口的函数；如果该模块使用隐式导出行为（这是罕见且不建议），则该模块的自动出口功能将包含在该模块的导出中，因此再次成为session-cession-cession-cession-clobally。}

^{[2]这个魔术有一个限制，但是，它只会表面很少： [switch] parameters 直接连接的布尔值参数不是支持的（例如， -casessentive：$ true ） - 参见此答案。}