掌握PowerShell函数：带参数调用函数综合指南

掌握如何使用参数调用 PowerShell 函数的 5 个关键步骤

曾几何时，在广阔而复杂的软件工程领域，专门的专业人员负责使用 PowerShell 自动执行日常任务。此人知道 PowerShell 函数是创建模块化和可重用脚本的基本构建块。但是，他们不确定如何使用参数调用 PowerShell 函数。如果您发现自己处于类似情况，那么这份综合指南非常适合您。

在本文中，我们将深入研究使用参数调用 PowerShell 函数的复杂性。让我们一起一步步揭开谜底。

1.了解PowerShell函数的基础知识

PowerShell 函数本质上是为执行特定任务而设计的命名代码块。为了充分理解如何使用参数调用 PowerShell 函数，我们首先来了解一下基本函数的结构。

一个简单的函数由 function 关键字组成，后跟函数名称和包含要执行的代码的脚本块。这是一个例子：

function Show-Message {
Write-Host “Hello, PowerShell!”
}

要调用此函数，只需键入其名称：

Show-Message

现在我们已经掌握了基础知识，让我们继续使用参数。

2. 在PowerShell函数中定义参数

要使用参数调用 PowerShell 函数，我们首先需要在函数中定义参数。在我们的示例中，假设我们希望能够自定义 Show-Message 函数显示的消息。

为此，我们可以使用 param 关键字，后跟括号中的参数名称列表。这是我们更新的功能：

function Show-Message {
param (
$Message
)
 Write-Host $Message
}

通过这个更新的函数，让我们探索使用参数调用它的不同方法。

3. 使用位置参数调用函数

使用参数调用 PowerShell 函数的一种方法是按位置提供值。这意味着参数值按照函数 param 块中定义的顺序提供。在我们的示例中，我们只有一个参数，因此我们可以像这样调用该函数：

Show-Message “Hello, World!”

该函数现在将显示自定义消息 Hello, World! 而不是硬编码的消息。

4. 使用命名参数调用函数

使用参数调用函数的另一种方法是使用命名参数。在这种方法中，我们指定参数名称及其值。这允许我们以任何顺序提供参数值并提高代码的可读性。要使用命名参数调用 Show-Message 函数，我们可以运行：

Show-Message -Message “Hello, World!”

这会产生与位置方法相同的输出。

5. 使用高级参数属性

PowerShell 提供了几个高级参数属性，使我们能够控制参数传递给函数的方式。一些常用的属性包括：

- *Mandatory*：指定调用函数时必须提供参数。
- *Position*：使用位置参数时指示参数的位置。
- *HelpMessage*：提供描述性信息交互式帮助消息。
- *ValidateScript*：定义用于验证参数值的脚本块。

让我们更新 Show-Message 函数，使 $Message 参数成为必需参数并包含帮助消息：

function Show-Message {
param (
[Parameter(Mandatory=$true, HelpMessage=”Enter your message”)]
$Message
)
 Write-Host $Message
}

通过这些更改，如果我们尝试在不提供 $Message 参数的情况下调用该函数，PowerShell 将提示我们提供所需的值。

最后的想法

现在我们已经介绍了如何使用参数调用 PowerShell 函数的基础知识，曾经困惑的软件工程师终于能够在他们的自动化之旅中继续前进。采用这些技术，您也可以创建适应各种场景的模块化、可重用的脚本。

记住关键步骤：

1. 了解 PowerShell 函数的基础知识。
2. 在函数中定义参数。
3. 使用位置参数调用函数。
4. 使用命名参数调用函数。
5利用高级参数属性进行更好的控制。

通过这些步骤，您将很好地掌握如何使用参数调用 PowerShell 函数。享受此技能带来的新功能和灵活性，并继续探索 PowerShell 提供的无限可能性。

Powershell 高级工具和脚本编写完整课程

15 个对初学者有用的 PowerShell 命令 |学习微软PowerShell

调用 PowerShell 函数时如何将参数传递给它？

在 PowerShell 中，您可以在调用函数时将参数传递给函数，方法是按照与函数定义中的参数相同的顺序提供参数，或者使用参数名称后跟参数值。

以下是接受两个参数的简单 PowerShell 函数的示例：

function Add-Numbers {
param (
[int] $Number1,
[int] $Number2
)
return $Number1 + $Number2
}

您可以通过以下方式将参数传递给该函数：

1. 位置参数：按照函数中定义的参数顺序提供参数。

Add-Numbers 5 7

2. 命名参数：使用参数名称及其各自的值。

Add-Numbers -Number1 5 -Number2 7

3. 您还可以混合使用位置参数和命名参数：

Add-Numbers 5 -Number2 7

请记住，使用命名参数可以使代码更具可读性并且不易出错，尤其是在使用具有许多输入参数的函数时。

如何在 PowerShell 命令行中调用带有参数的函数？

在 PowerShell 命令行中，您可以通过首先定义函数，然后使用所需参数调用它来调用带有参数的函数。这是一个例子：

1. 定义您的功能：

function MyFunction($arg1) {
Write-Output “Argument passed: $arg1”
}

2. 使用参数调用函数：

MyFunction “Hello, World!”

在此示例中，MyFunction 是函数的名称，$arg1 是输入参数。当您使用参数调用该函数时，例如 Hello, World!，该函数将输出 Argument Passed: Hello, World!。

请记住，在 PowerShell 中，您还可以在调用函数时传递命名参数。例如：

MyFunction -arg1 “Hello, World!”

如何使用 PowerShell 命令行中的参数执行 PowerShell 脚本？

要使用 PowerShell 命令行中的参数执行 PowerShell 脚本，请执行以下步骤：

1. 打开 PowerShell 命令行或 PowerShell 集成脚本环境 (ISE)。

2. 使用 cd 命令导航到脚本所在的目录，后跟目录路径。例如：

cd C:Scripts

3. 要使用参数执行脚本，请键入脚本文件的名称，后跟要作为参数传递的参数。在脚本名称前使用 . 前缀表示您要在当前目录中运行该脚本。例如，如果您的脚本名为 YourScript.ps1 并且它接受两个参数 Param1 和 Param2，您将像这样执行它：
“`
.YourScript.ps1 -Param1 Value1 -Param2 Value2
“`
替换 Value1 和 Value2 以及您想要作为参数传递的实际值。

4. 按Enter 以使用指定参数运行脚本。

请记住始终确保您的 PowerShell 执行策略允许运行脚本。如果没有，您可以使用 Set-ExecutionPolicy cmdlet 设置适当的执行策略。例如，要允许运行由受信任的发布者签名的脚本，您可以使用以下命令：

Set-ExecutionPolicy RemoteSigned

如何调用 PowerShell 函数？

在 PowerShell 命令行中，您可以通过简单地调用函数名称并后跟所需参数（如果有）来调用函数。要定义和调用函数，请按照下列步骤操作：

1. 首先，使用 function 关键字创建一个函数，后跟函数名称和用大括号 {} 括起来的脚本块。在脚本块中，您可以编写函数的代码。

例如，让我们创建一个名为“Get-Sum”的简单函数，它接受两个数字作为输入并返回它们的总和。

function Get-Sum {
param(
[int]$Number1,
[int]$Number2
)
return $Number1 + $Number2
}

2. 定义函数后，您可以通过调用其名称并传递所需参数（如果有）来调用它。在我们的例子中，我们需要传递两个数字作为参数。

$result = Get-Sum -Number1 5 -Number2 7
Write-Host “The sum is: $result”

这将输出：总和是：12

总之，要在命令行中调用 PowerShell 函数，首先需要定义该函数，然后在提供所需参数的同时通过其名称调用它。这个过程的关键要素是函数定义和函数调用。

从命令行调用 PowerShell 函数时，如何有效地将多个参数传递给该函数？

在 PowerShell 中，当从命令行调用函数时，可以使用命名参数、位置参数或两者的组合，有效地将多个参数传递给函数。

命名参数：
您可以通过参数名称传递参数，这使您的代码更具可读性，并避免与参数顺序混淆。要使用命名参数，请指定参数名称，后跟冒号和值。

例如，假设我们有一个名为“计算”的函数：

function Calculate {
param(
[int]$Number1,
[int]$Number2,
[string]$Operation
)
# Function implementation
}

您可以使用命名参数从命令行调用此函数，如下所示：

Calculate -Number1:5 -Number2:3 -Operation:”Add”

位置参数：
传递多个参数的另一种方法是使用它们在函数定义中的位置。在这种情况下，您不需要指定参数名称，只需按照函数中定义的顺序提供值即可。

使用相同的“计算”函数，您可以使用位置参数从命令行调用它：

Calculate 5 3 “Add”

命名参数和位置参数的组合：
从命令行调用函数时，您还可以组合命名参数和位置参数。只需确保首先提供位置参数，然后提供命名参数。

例如：

Calculate 5 3 -Operation:”Add”

在本例中，“5”和“3”作为 $Number1 和 $Number2 的位置参数提供，而“Operation”参数则使用其名称指定。

在命令行界面中使用命名参数调用 PowerShell 函数的正确语法是什么？

在 PowerShell 命令行中，调用具有命名参数的函数的正确语法如下：

FunctionName -ParameterName1 Value1 -ParameterName2 Value2

例如，假设您有一个名为 Add-Numbers 的函数，它接受两个命名参数 Number1 和 Number2：

function Add-Numbers {
param (
[int]$Number1,
[int]$Number2
)
 $result = $Number1 + $Number2
Write-Output $result
}

要使用命名参数在命令行界面中调用此函数，您可以使用：

Add-Numbers -Number1 5 -Number2 10

这里，Add-Numbers是函数名称，-Number1和-Number2是命名参数，5和 10 分别是传递给这些参数的值。

如何正确使用 splatting 将参数传递给从命令行调用的 PowerShell 函数？

在 PowerShell 中，splatting 是一种使用单个变量将参数值集合传递给函数的技术。当处理大量参数或可读性很重要时，这会很有帮助。要使用展开，您需要创建一个包含参数名称及其值的哈希表，然后使用 @ 符号将其传递给函数。具体做法如下：

1. 首先，创建一个带有多个参数的 PowerShell 函数。例如：

function Test-Splatting {
param(
[string]$Parameter1,
[int]$Parameter2,
[bool]$Parameter3
)
 Write-Host “Parameter1: $Parameter1”
Write-Host “Parameter2: $Parameter2”
Write-Host “Parameter3: $Parameter3”
}

2. 接下来，使用参数名称及其对应值创建一个哈希表：

$parameters = @{
‘Parameter1’ = ‘Hello, World!’
‘Parameter2’ = 42
‘Parameter3’ = $true
}

3. 现在，您可以使用 splatting 通过使用 @ 符号将所有参数传递给函数：

Test-Splatting @parameters

这将产生以下输出：

Parameter1: Hello, World!
Parameter2: 42
Parameter3: True

使用splatting使您的命令行调用更具可读性且更易于管理，尤其是在使用具有大量参数的函数时。