关于方法
简短说明
介绍如何使用方法在 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 开始，支持使用动态方法名称调用方法。
了解方法
若要查找对象方法的定义，请转到对象类型的帮助主题并查找其方法页。 例如，以下页面介绍了进程对象 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 方法。
第一个命令启动记事本进程的三个实例。 Get-Process 获取记事本进程的所有三个实例，并将其保存在 变量中 $p 。
Notepad; Notepad; Notepad
$p = Get-Process Notepad
$p.Count
3
下一个命令对 变量中的所有$p三个进程运行 Kill 方法。 即使进程集合没有方法， Kill 此命令也能正常工作。
$p.Kill()
Get-Process Notepad
命令 Get-Process 确认 Kill 方法是否正常工作。
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
此示例在功能上等效于使用 Foreach-Object cmdlet 在集合中的每个对象上运行 方法。
$p | ForEach-Object {$_.Kill()}
ForEach 和 Where 方法
从 PowerShell 4.0 开始，支持使用方法语法筛选集合。 这允许在处理集合 ForEach 和 Where时使用两个新方法。
可阅读 about_arrays 了解有关这些方法的详细信息
在存在多个重载时调用特定方法
调用 .NET 方法时，请考虑以下方案。 如果方法采用对象，但通过采用更具体类型的接口具有重载，则 PowerShell 会选择接受对象的方法，除非你将其显式强制转换为该接口。
Add-Type -TypeDefinition @'
// Interface
public interface IFoo {
string Bar(int p);
}
// Type that implements the interface
public class Foo : IFoo {
// Direct member method named 'Bar'
public string Bar(object p) { return $"object: {p}"; }
// *Explicit* implementation of IFoo's 'Bar' method().
string IFoo.Bar(int p) {
return $"int: {p}";
}
}
'@
在此示例中，选择了 Bar 方法的不太具体的object重载。
[Foo]::new().Bar(1)
object: 1
在此示例中，我们将 方法强制转换为接口 IFoo ，以选择 Bar 方法的更具体的重载。
([IFoo] [Foo]::new()).Bar(1)
int: 1