向PetSerAl 致敬以寻求帮助。
New-Module
默认情况下返回新创建的模块,作为一个[System.Management.Automation.PSModuleInfo]
实例。
通过“返回一个空对象”,我假设您的意思是让您的模块导出变量$commonProperties
(它恰好包含一个[pscustomobject]
实例,但这是偶然的),但您的代码未能这样做。
原因是在没有Export-ModuleMember
调用的情况下,变量和别名(与函数不同)不会自动从模块中导出。
注意事项:
如果存在一个或多个Export-ModuleMember
调用,则仅导出指定的成员(不会自动导出任何内容)。
Export-ModuleMember
调用最好放在模块定义的底部,因为它们必须在元素定义之后才能导出。
如果要将导入当前会话的导出成员集限制为模块功能的子集,可以使用New-Module
's-Function
参数。
- 如果该模块仅在当前会话中使用,则
New-Module -Function
与Export-ModuleMember
;结合没有意义。还要注意 using-Function
会阻止非函数成员被导入当前会话。
- 结合默认的导出行为,
New-Module -Function
有效地提供了一种Export-ModuleMember
在脚本块内使用带有函数名称的显式调用的替代方法,但重要的是要了解这两种机制的不同。
要导出变量$commonProperties
,您需要调用Export-ModuleMember -Variable commonProperties
$
(注意变量名中需要缺少前缀):
$newModule = New-Module -ScriptBlock {
$resourcesDirectory="AA"
$commonProperties = New-Object PSObject -Property @{
ResourcesDirectory = $resourcesDirectory
}
# You must explicitly export variable $commonProperties.
# Note that `Export-ModuleMember` must generally come *after* the
# definition of the variable, and that the variable name
# must not be $-prefixed.
Export-ModuleMember -Variable commonProperties
# (No need to `return` anything from the script block.
# Any output will be ignored.)
} -name GetXXX
鉴于New-Module
不仅创建了一个新模块而且自动导入它,$commonProperties
现在在当前会话中可用。
旁注:
通过添加 switch ,您-ReturnResult
可以告诉New-Module
返回脚本块的输出而不是新创建的模块对象(但模块仍然导入到当前会话中)。
由于该语句,应用于将返回variable值的代码,但如前所述,您的脚本块不会导出任何成员,因此当前会话不会看到variable。$commonProperties
return $commonProperties
$commonProperties
或者, switch-AsCustomObject
告诉New-Module
返回一个[pscustomobject]
实例,其成员是导出的成员。
请注意,正常的导出规则适用,并且模块仍在幕后创建,尽管它没有导入。
应用于您的(更正的)代码,并Foo
添加了导出功能:
$newObj = New-Module -ScriptBlock {
$resourcesDirectory="AA"
$commonProperties = New-Object PSObject -Property @{
ResourcesDirectory = $resourcesDirectory
}
function Foo { "I'm here." }
Export-ModuleMember -Variable commonProperties -Function Foo
} -AsCustomObject
$newObj
现在包含一个名为的属性,该属性commonProperties
引用$commonProperty
来自新(隐藏)模块的脚本块的变量。
注意:Get-Member
误导性地将此属性的类型报告为NoteProperty
,暗示一个静态值,而导出的函数可能会改变基础变量的值(尽管这让我觉得很奇怪)。[System.Management.Automation.PSVariableProperty]
正如所$newObj.psobject.properties['commonProperties'].GetType().FullName
揭示的那样,真正的类型是,而真正的NoteProperty
成员具有 type [System.Management.Automation.PSNoteProperty]
。
类似地,导出的函数 Foo
表面为ScriptMethod
-type 成员(方法),在新(隐藏)模块的上下文中运行并查看其变量。
(顺便说一句:$newObj.Foo.Script.Module
可用于访问隐藏模块。)
相比之下,导出的别名似乎被忽略了。
警告:不要以相同的名称导出不同类型的成员(例如,不要定义同名的函数和变量),因为只有其中一个可以访问。