关于方法

项目
06/21/2023

简短说明

介绍如何使用方法在 PowerShell 中对对象执行操作。

长说明

PowerShell 使用对象来表示数据存储中的项或计算机的状态。例如，FileInfo 对象表示文件系统驱动器中的文件，ProcessInfo 对象表示计算机上的进程。

对象具有属性（用于存储有关对象的数据）和可用于更改对象的方法。

“方法”是一组指令，用于指定可以对对象执行的操作。例如， FileInfo 对象包括 CopyTo 复制对象表示 FileInfo 的文件的方法。

若要获取任何对象的方法，请使用 Get-Member cmdlet。使用值为“Method”的 MemberType 属性。以下命令获取进程对象的方法。

Get-Process | Get-Member -MemberType Method

TypeName: System.Diagnostics.Process

Name                      MemberType Definition
----                      ---------- ----------
BeginErrorReadLine        Method     System.Void BeginErrorReadLine()
BeginOutputReadLine       Method     System.Void BeginOutputReadLine()
...
Kill                      Method     System.Void Kill()
Refresh                   Method     System.Void Refresh()
Start                     Method     bool Start()
ToString                  Method     string ToString()
WaitForExit               Method     bool WaitForExit(int milliseconds), ...
WaitForInputIdle          Method     bool WaitForInputIdle(int millisecon...

若要执行或“调用”对象的方法，请键入一个点 (.) 、方法名称和一组括号“ () ”。如果方法具有参数，请将参数值放在括号内。每个方法调用都需要括号，即使没有参数也是如此。如果方法采用多个参数，则应用逗号分隔它们。

例如，以下命令调用进程的 Kill 方法以结束计算机上的记事本进程。

$notepad = Get-Process notepad
$notepad.Kill()

可以通过组合上述语句来缩短此示例。

(Get-Process Notepad).Kill()

命令 Get-Process 括在括号中，以确保它在调用 Kill 方法之前运行。然后，对 Kill 返回 Process 的对象调用方法。

另一种非常有用的方法是 Replace 字符串方法。方法 Replace 替换字符串中的文本。在下面的示例中，点 (.) 可以紧跟在字符串的尾引号后面。

'this is rocket science'.Replace('rocket', 'rock')

this is rock science

如前面的示例所示，可以使用命令、变量中的对象或导致对象的任何对象调用方法， (如引号) 中的字符串。

从 PowerShell 4.0 开始，支持使用动态方法名称调用方法。

了解方法

若要查找对象方法的定义，请转到 MSDN 中对象类型的帮助主题并查找其方法页。例如，以下页面介绍了进程对象 System.Diagnostics.Process 的方法。

若要确定方法的参数，请查看方法定义，这类似于 PowerShell cmdlet 的语法图。

方法定义可能具有一个或多个方法签名，这些签名类似于 PowerShell cmdlet 的参数集。签名显示调用方法的所有有效命令格式。

例如， CopyTo 类的 FileInfo 方法包含以下两个方法签名：

    CopyTo(String destFileName)
    CopyTo(String destFileName, Boolean overwrite)

第一个方法签名采用目标文件名 (和路径) 。以下示例使用第一 CopyTo 种方法将 Final.txt 文件复制到 C:\Bin 目录。

(Get-ChildItem c:\final.txt).CopyTo("c:\bin\final.txt")

注意

与 PowerShell 的参数 模式不同，对象方法在 表达式 模式下执行，表达式模式是传递到 PowerShell 所基于的 .NET 框架。在 表达式 模式下，不允许使用无引号字符串 (裸字参数) 。可以在差异路径（作为参数）和路径（作为参数）中看到这一点。可以在 about_Parsing 中详细了解分析模式

第二个方法签名采用目标文件名和布尔值，该值确定是否应覆盖目标文件（如果已存在）。

以下示例使用第二CopyTo种方法将文件复制到Final.txtC:\Bin目录，并覆盖现有文件。

(Get-ChildItem c:\final.txt).CopyTo("c:\bin\final.txt", $true)

标量对象和集合的方法

特定类型的一个 (“scalar”) 对象的方法通常不同于同一类型的对象集合的方法。

例如，每个进程都有一个 Kill 方法，但进程集合没有 Kill 方法。

从 PowerShell 3.0 开始，PowerShell 会尝试防止标量对象和集合的不同方法导致的脚本错误。

如果提交集合，但请求仅在单个 (“scalar”) 对象上存在的方法，PowerShell 将在集合中的每个对象上调用该方法。

如果方法存在于单个对象和集合上，则仅调用集合的方法。

此功能还适用于标量对象和集合的属性。有关详细信息，请参阅 about_Properties。

示例

以下示例在进程对象的集合上运行单个进程对象的 Kill 方法。此示例仅适用于 PowerShell 3.0 及更高版本的 PowerShell。

第一个命令启动记事本进程的三个实例。第二个命令使用 Get-Process 命令获取记事本进程的所有三个实例，并将其保存在 $p 变量中。

Notepad; Notepad; Notepad
$p = Get-Process Notepad

第三个命令使用所有集合的 Count 属性来验证$p变量中是否有三个进程。

$p.Count

第四个命令对 $p 变量中的所有三个进程运行 Kill 方法。

即使进程集合没有方法， Kill 此命令也能正常工作。

$p.Kill()

第五个命令使用 Get-Process 命令来确认命令 Kill 是否正常工作。

Get-Process Notepad

Get-Process : Cannot find a process with the name "notepad". Verify the proc
ess name and call the cmdlet again.
At line:1 char:12
+ Get-Process <<<<  notepad
    + CategoryInfo          : ObjectNotFound: (notepad:String) [Get-Process]
, ProcessCommandException
    + FullyQualifiedErrorId : NoProcessFoundForGivenName,Microsoft.PowerShel
l.Commands.GetProcessCommand

若要在 PowerShell 2.0 上执行相同的任务，请使用 Foreach-Object cmdlet 在集合中的每个对象上运行方法。

$p | ForEach-Object {$_.Kill()}

ForEach 和 Where 方法

从 PowerShell 4.0 开始，支持使用方法语法筛选集合。这允许在处理集合 ForEach 和 Where时使用两个新方法。

可阅读 about_arrays 了解有关这些方法的详细信息

另请参阅

about_Objects

about_Properties

Get-Member

通过