PowerShell 技能连载 - 脚本模块化设计

模块化基础

# 函数封装示例
function Get-SystemHealth {
    [CmdletBinding()]
    param(
        [ValidateSet('Basic','Full')]
        [string]$DetailLevel = 'Basic'
    )
    # 健康检查逻辑...
}

# 模块导出配置
Export-ModuleMember -Function Get-SystemHealth

应用场景

1. 自动化脚本包：

   # 模块目录结构
   MyModule/
   ├── Public/
   │   └── Get-SystemHealth.ps1
   └── MyModule.psd1

2. 模块分发使用：

   # 安装模块
   Copy-Item -Path ./MyModule -Destination $env:PSModulePath.Split(';')[0] -Recurse
   Import-Module MyModule

最佳实践

1. 分离公共/私有函数

2. 实现模块帮助文档

3. 版本控制规范：

   # 模块清单配置
   @{
       ModuleVersion = '1.2.0'
       FunctionsToExport = @('Get-SystemHealth')
       RequiredModules = @('PSScriptAnalyzer')
   }

4. 依赖管理：

   # 需求声明
   #Requires -Modules @{ModuleName='Pester';ModuleVersion='5.3.1'}
   #Requires -Version 7.0