Export-CrescendoModule

从 PowerShell Crescendo JSON 配置文件创建模块

语法

Export-CrescendoModule
      [-ConfigurationFile] <String[]>
      [-ModuleName] <String>
      [-Force]
      [-NoClobberManifest]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

此 cmdlet 导出可转换为充当特定于平台命令的代理的函数的对象。 生成的模块文件应可执行到 PowerShell 版本 5.1。

该 cmdlet 创建模块 .psm1 和模块清单 .psd1 文件。 当自定义模块清单超出 Crescendo 范围时,这可能导致问题。 使用 NoClobberManifest 参数防止覆盖清单。

示例

示例 1

Export-CrescendoModule -ModuleName netsh -ConfigurationFile netsh*.json
Import-Module ./netsh.psm1

示例 2

Export-CrescendoModule netsh netsh*.json -force

参数

-ConfigurationFile

这是表示模块代理的 JSON 文件列表。

类型:String[]
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:True

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

默认情况下,如果 Export-CrescendoModule 不会覆盖现有模块。 使用 Force 参数覆盖现有文件,或在运行 Export-CrescendoModule之前将其删除。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-ModuleName

要创建的模块文件的名称。 可以省略尾随 .psm1

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NoClobberManifest

防止覆盖模块清单。

必须使用任何新的 cmdlet 和设置手动更新清单。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PassThru

发出一个对象,其中包含 .psm1 的路径和 New-ModuleManifest 的参数。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 该 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String[]

输出

Object

备注

在内部,此函数调用返回命令对象的 Import-CommandConfiguration cmdlet。 然后,ConfigurationFile 参数中提供的所有文件用于创建每个单独的函数。 最后,所有代理都用于创建 Export-ModuleMember 命令调用,因此导入生成的模块时,该模块具有所有可用的命令代理。

Export-CrescendoModule 将 crescendoBuilt 标记添加到模块清单。 可以使用此标记在使用 Crescendo 创建的 PowerShell 库中查找模块。 有关详细信息,请参阅: