Compare-Object

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

L’applet de commande Compare-Object compare deux ensembles d’objets. Un ensemble d’objets est la référence , et l’autre ensemble d’objets est la différence .

Le résultat de la comparaison indique si une valeur de propriété apparaît uniquement dans l’objet référence (<=) ou uniquement dans l’objet différence (=>). Si le paramètre IncludeEqual est utilisé, (==) indique que la valeur se trouve dans les deux objets.

Si la référence ou la différence de objets sont null ($null), Compare-Object génère une erreur de fin.

Certains exemples utilisent la mise en forme pour réduire la longueur de ligne des exemples de code. Pour plus d'informations, consultez À propos de la projection. Et les exemples utilisent deux fichiers texte, avec chaque valeur sur une ligne distincte. Testfile1.txt contient les valeurs : chien, écureuil et oiseau. Testfile2.txt contient les valeurs : chat, oiseau et racon.

Cet exemple compare le contenu de deux fichiers texte. La sortie affiche uniquement les lignes qui sont différentes entre les fichiers. est l’objet de référence () et est l’objet de différence ().

Les lignes avec du contenu qui apparaissent dans les deux fichiers ne sont pas affichées.

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

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

Cet exemple utilise le IncludeEqual pour comparer chaque ligne de contenu dans deux fichiers texte. Toutes les lignes de contenu des deux fichiers sont affichées.

Le SideIndicator spécifie si la ligne apparaît dans l’objet de référence (), différence objet () ou les deux fichiers ().

$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    <=

Cet exemple utilise les paramètres IncludeEqual et ExcludeDifferent pour comparer chaque ligne de contenu dans deux fichiers texte.

Étant donné que la commande utilise le paramètre ExcludeDifferent , la sortie contient uniquement des lignes contenues dans les deux fichiers, comme le montre l' 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        ==

Cet exemple compare deux ensembles d’objets qui contiennent les processus en cours d’exécution de l’ordinateur.

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

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

L’applet de commande Get-Process obtient les processus en cours d’exécution de l’ordinateur et les stocke dans la variable $Processes_Before.

L’application notepad.exe est démarrée.

Get-Process obtient la liste mise à jour de l’ordinateur des processus en cours d’exécution et les stocke dans la variable $Processes_After.

Les Compare-Object comparent les deux ensembles d’objets de processus stockés dans les variables $Processes_Before et $Processes_After. La sortie affiche la différence, notepad.exe, de l’objet $Processes_After.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez envoyer un objet vers le bas du pipeline au paramètre DifferenceObject.

Si la référence objet et la différence de 'objet sont identiques, il n’y a pas de sortie.

Si les objets sont différents, Compare-Object encapsule les objets différents dans un wrapper PSCustomObject avec un SideIndicator propriété pour référencer les différences. Lorsque vous utilisez le paramètre PassThru , omettez le wrapper autour des objets comparés et retourne les objets différents, inchangés.