Сравнивает два набора объектов.

Синтаксис

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

Описание

Командлет Compare-Object сравнивает два набора объектов. Один набор объектов является эталонным, а другой — отличающимся.

Результат сравнения позволяет узнать, было ли обнаружено значение свойства только в объекте из эталонного набора (символ <=), только в объекте из отличающегося набора (символ =>) или, если указан параметр IncludeEqual, в обоих объектах (символ ==).

Параметры

-CaseSensitive

Указывает, что сравнение должно выполняться с учетом регистра.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Culture <string>

Задает культуру, используемую при сравнении.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-DifferenceObject <PSObject[]>

Задает объекты, которые будут сравниваться с эталонными.

Обязательно?	true
Позиция?	2
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue)
Принимать подстановочные знаки?	false

-ExcludeDifferent

Отображает только совпадающие характеристики сравниваемых объектов.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-IncludeEqual

Отображает совпадающие характеристики сравниваемых объектов. По умолчанию отображаются только те характеристики, которые различаются в эталонном и отличающемся объектах.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-PassThru

Передает по конвейеру различающиеся объекты. По умолчанию этот командлет не формирует никаких выходных данных.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Property <Object[]>

Задает сравниваемые свойства эталонного и отличающегося объектов.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-ReferenceObject <PSObject[]>

Объекты, используемые при сравнении в качестве эталона.

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-SyncWindow <int>

Задает область поиска, в которой выполняется попытка повторной синхронизации порядка при отсутствии совпадений. По умолчанию используется значение [Int32]::MaxValue.

Обязательно?	false
Позиция?	named
Значение по умолчанию	[Int32]::MaxValue
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

System.Management.Automation.PSObject

Можно передать объект DifferenceObject командлету Compare-Object по конвейеру.

Выходные данные

Нет или отличающиеся объекты

Если задан параметр PassThru, командлет Compare-Object возвращает отличающиеся объекты. В противном случае этот командлет не формирует никаких выходных данных.

Пример 1

C:\PS>compare-object -referenceobject $(get-content C:\test\testfile1.txt) -differenceobject $(get-content C:\test\testfile2.txt)

Описание
-----------
Эта команда сравнивает содержимое двух текстовых файлов. Она выводит только те строки, которые имеются только в одном из двух файлов, но не в обоих.

Пример 2

C:\PS>compare-object -referenceobject $(get-content C:\Test\testfile1.txt) -differenceobject $(get-content C:\Test\testfile2.txt) -includeequal

Описание
-----------
Эта команда построчно сравнивает содержимое двух текстовых файлов. Она выводит все строки обоих файлов, указывая при этом для каждой строки, имеется ли она только в файле Textfile1.txt, файле Textfile2.txt или в обоих файлах.

Пример 3

C:\PS>$processes_before = get-process

C:\PS> notepad

C:\PS> $processes_after  = get-process

C:\PS> compare-object -referenceobject $processes_before -differenceobject $processes_after

Описание
-----------
Эти команды сравнивают два набора объектов процессов. 

Первая команда с помощью командлета Get-Process получает выполняющиеся на компьютере процессы. Они сохраняются в переменной $processes_before. 

Вторая команда запускает Блокнот (Notepad).

В третьей команде снова используется командлет Get-Process и полученные процессы сохраняются в переменной $processes_after. 

Четвертая команда с помощью командлета Compare-Object выполняет сравнение двух наборов объектов процессов. Она выводит список различий между ними, в который входит новый экземпляр Блокнота (Notepad).

Compare-Object