PowerShell 基础66 条

函数定义与返回值

function 封装可复用逻辑：输出流即返回值，任何未消费的输出都会混入结果，这是新手最常踩的坑。

用途	封装可复用逻辑
语法	function 名称 { param($a) ... }；高级函数加 [CmdletBinding()]
返回规则	函数内所有输出都成为返回值；return 只是提前结束

常用示例

function Get-Disk-Free {
  param([string]$Drive = 'C:')
  (Get-PSDrive $Drive[0]).Free / 1GB
}
Get-Disk-Free

要“只返回一件事”时把中间输出写进变量或 Write-Verbose，避免污染返回值。

‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌