PowerShell PS默认参数值

PSDefaultParameterValue 是一个哈希表，允许我们用我们自己想要的默认值覆盖任何 cmdlet 上任何参数的默认值。

然后，cmdlet 将使用自定义默认值，除非在命令中指定了不同的值。

这听起来可能不是最重要的功能，但相信我，读完这篇文章后，您会问自己，如果没有它，您是如何工作的。

如何使用 PowerShell PSDefaultParameterValues

参数

让我们仔细看看如何设置默认值。

$PSDefaulParameterValues.Add("Command:Parameter","Value")

正如您所看到的，我们只需向哈希表添加一个新键，指定要设置默认值的 cmdlet 和参数，并用 : 分隔。该值显然需要是参数接受的类型，否则在使用 cmdlet 时将会出现错误。
一个具体的示例是为 Write-Host指定自定义分隔符。

# Default
PS> Write-Host "Hello","World"
Hello World
# Adding the custom default
PS> $PSDefaultParameterValues.Add("Write-Host:Separator", "`n")
# Changed output
PS> Write-Host "Hello","World"
Hello
World

开关

对于开关参数来说，这几乎是相同的，我们只是使用一个布尔值来指示是否希望开关存在 $true 或不存在 $false。

例如，我们可以使用它同时启用脚本中所有 Invoke-WebRequest 调用的调试。

# Default, no verbosity
PS> (Invoke-WebRequest "https://ps1.guru").StatusCode 
200
# Adding the custom default
PS> $PSDefaultParameterValues.Add("Invoke-WebRequest:Verbose", $true)
# Changed output, with verbosity
PS> (Invoke-WebRequest "https://ps1.guru").StatusCode
VERBOSE: GET https://ps1.guru/ with 0-byte payload
VERBOSE: received 4801-byte response of content type text/html
200

通配符

继续使用上一个示例中的 Verbose 参数，我们可以使用通配符来设置它对于所有 cmdlet。这是我经常用来调试脚本的一个很棒的技巧。

PS> $PSDefaultParameterValues.Add("*:Verbose", $true)

先进价值观

可以使用脚本块作为参数的默认值，而不是静态值。这可以根据系统状态（例如您所在的主机、当前目录等）实现极端程度的自定义。

继续使用之前的详细示例，我们可以使其行为依赖于变量 $verbose。

PS> $PSDefaultParameterValues.Add("*:Verbose", {$verbose -eq $true})

现在我们可以通过设置和删除变量来控制会话的默认详细程度。请记住，每次使用 cmdlet 时都会运行此脚本块，因此请保持速度快。你可以这样测量：

PS> Measure-Command {$verbose -eq $true} | ft
Days	Hours	Minutes Seconds Milliseconds
---- 	----- 	------- ------- ------------
0       0       0       0       0

坚持

我们到目前为止所做的一切都不会在会话之间保留，默认情况下，您需要将它们添加到您的个人资料中。要查找您在当前会话中添加的所有默认值，只需像这样查询历史记录即可。

Get-History | Where-Object CommandLine -like "`$PSDEfaultParameterValues*"

PSDefaultParameterValues 的真实示例

您可能会问为什么这是一件好事，让我向您展示一个简单的例子。

假设您总是将数据导出到 CSV 文件以供其他人在 Excel 中打开。如果他们只是双击您的 CSV，他们将不会得到很好的结果。

图 1：Excel 中导入的数据

然后，我们大多数人只需打开一个新的 Excel 文件并使用数据>从文本导入数据，单击大量屏幕并配置 Excel 以实际检测分隔符。

图2：手动编辑的数据导入

但还有更好的方法！而不是仅仅导出 CSV。

Get-Process -Name Microsoft* | Export-Csv msproc.csv

您可以指定自定义分隔符，并在使用时删除类型信息和破坏符。

Get-Process -Name Microsoft* | Export-Csv bettermsproc.csv -Delimiter ";"
-NoTypeInformation -NoClobber

现在导入、导出、转换为 CSV 以及转换为 CSV 将使用分隔符 ；并且不包含任何类型信息或破坏者。

如果您直接使用 Excel 打开生成的 CSV 文件，您可以看到类似于我们之前所做的数据导入舞蹈的结果。

图 3：使用 PowerShell 配置后的数据导入

但总是输入这些参数很麻烦，并且固有的误差范围很大。
这是我们设置一些默认值的地方

$PSDefaultParams.Add("Export-Csv:Delimiter", ";")
$PSDefaultParams.Add("Export-Csv:NoTypeInformation", $true)
$PSDefaultParams.Add("Export-Csv:NoClobber", $true)

这样，我们就可以回到简单地使用 Export-Csv，并且生成的文件将按预期在 Excel 中打开。
我们甚至可以更进一步，使用通配符更改 CSV 系列中所有 cmdlet 的这些参数。

$PSDefaultParams.Add("*-Csv:Delimiter", ";")
$PSDefaultParams.Add("*-Csv:NoTypeInformation", $true)
$PSDefaultParams.Add("*-Csv:NoClobber", $true)

在脚本中使用 PSDefaultParameterValues

现在您已经了解了 $PSDefaulParameterValues 我想提醒您 - 请不要'不要使用它们

在你的脚本中。

这样做有一些很好的理由：

• 其他用户可能没有您的默认值，因此脚本将因他们而中断
• 您可以更改默认值，脚本将会为您中断

为了缓解这种情况，我建议首先在所有脚本中禁用PSDefaultParameterValues：

# Disable PSDefaultParameterValues
$PSDefaultParameterValues.Add("Disabled", $true)

并在最后重新启用它们：

# Re-Enable PSDefaultParameterValues
$PSDefaultParameterValues.Remove("Disabled")