Compare-Object

语法

Compare-Object
       [-ReferenceObject] <PSObject[]>
       [-DifferenceObject] <PSObject[]>
       [-SyncWindow <Int32>]
       [-Property <Object[]>]
       [-ExcludeDifferent]
       [-IncludeEqual]
       [-PassThru]
       [-Culture <String>]
       [-CaseSensitive]
       [<CommonParameters>]

说明

Compare-Object cmdlet 比较两组对象。 一组对象是 引用，另一组对象是 差异。

比较的结果指示属性值仅出现在 引用 对象（<=）中，还是仅出现在 差异 对象（=>）。 如果使用了 IncludeEqual 参数，则 （==） 指示值在这两个对象中。

如果 引用 或 差异 对象为 null（$null），Compare-Object 将生成终止错误。

一些示例使用旋转来减少代码示例的行长度。 有关详细信息，请参阅 about_Splatting。 此外，这些示例使用两个文本文件，每个文本文件都位于单独的行中。 Testfile1.txt 包含值：狗、松鼠和鸟。 Testfile2.txt 包含值：猫、鸟和龙。

示例

示例 1：比较两个文本文件的内容

此示例比较两个文本文件的内容。 输出仅显示文件之间的不同行。 是 引用 对象（），是 对象（）的 差异。

不显示两个文件中显示的内容行。

Compare-Object -ReferenceObject $(Get-Content -Path C:\Test\Testfile1.txt) -DifferenceObject $(Get-Content -Path C:\Test\Testfile2.txt)

InputObject SideIndicator
----------- -------------
cat         =>
racoon      =>
dog         <=
squirrel    <=

示例 2：比较两个文本文件中每行内容

此示例使用 IncludeEqual 比较两个文本文件中每行内容。 将显示这两个文件中的所有内容行。

SideIndicator 指定行出现在 Testfile1.txt引用 对象（<=）、Testfile2.txt差异 对象（=>）或两个文件（==）。

$objects = @{
ReferenceObject = $(Get-Content -Path C:\Test\Testfile1.txt)
DifferenceObject = $(Get-Content -Path C:\Test\Testfile2.txt)
}
Compare-Object @objects -IncludeEqual

InputObject SideIndicator
----------- -------------
bird        ==
cat         =>
racoon      =>
dog         <=
squirrel    <=

示例 3：比较每行内容并排除差异

此示例使用 IncludeEqual 和 ExcludeDifferent 参数来比较两个文本文件中每行内容。

由于该命令使用 ExcludeDifferent 参数，因此输出仅包含这两个文件中包含的行，如 SideIndicator（==所示）。

$objects = @{
ReferenceObject = $(Get-Content -Path C:\Test\Testfile1.txt)
DifferenceObject = $(Get-Content -Path C:\Test\Testfile2.txt)
}
Compare-Object @objects -IncludeEqual -ExcludeDifferent

InputObject SideIndicator
----------- -------------
bird        ==

示例 4：比较两组进程对象

此示例比较了包含计算机正在运行的进程的两组对象。

$Processes_Before = Get-Process
notepad.exe
$Processes_After = Get-Process
Compare-Object -ReferenceObject $Processes_Before -DifferenceObject $Processes_After

InputObject                            SideIndicator
-----------                            -------------
System.Diagnostics.Process (notepad)   =>

Get-Process cmdlet 获取计算机的正在运行的进程，并将其存储在 $Processes_Before 变量中。

启动 notepad.exe 应用程序。

Get-Process 获取计算机的正在运行的进程更新列表，并将其存储在 $Processes_After 变量中。

Compare-Object 比较存储在 $Processes_Before 和 $Processes_After 变量中的两组进程对象。 输出显示 $Processes_After 对象的差异（notepad.exe）。

参数

-CaseSensitive

-Culture

-DifferenceObject

-ExcludeDifferent

-IncludeEqual

-PassThru

-Property

-ReferenceObject

-SyncWindow

输入

PSObject

可以将对象向下发送到 DifferenceObject 参数。

输出

None

如果 引用 对象和 差异 对象相同，则没有输出。

PSCustomObject

如果对象不同，Compare-Object 使用 SideIndicator 属性将不同对象包装在 PSCustomObject 包装器中以引用差异。 使用 PassThru 参数时，Compare-Object 省略比较对象周围的 PSCustomObject 包装器，并返回不同的对象，保持不变。

相关链接

• ForEach-Object
• Group-Object
• Measure-Object
• New-Object
• Select-Object
• Sort-Object
• Tee-Object
• Where-Object
• Get-Process