Compare-Object
İki nesne kümesini karşılaştırır.
Syntax
Default (Varsayılan)
Compare-Object
[-ReferenceObject] <PSObject[]>
[-DifferenceObject] <PSObject[]>
[-SyncWindow <Int32>]
[-Property <Object[]>]
[-ExcludeDifferent]
[-IncludeEqual]
[-PassThru]
[-Culture <String>]
[-CaseSensitive]
[<CommonParameters>]
Description
Compare-Object cmdlet'i iki nesne kümesini karşılaştırır. Bir nesne kümesi,
Compare-Object bir nesnenin tamamını karşılaştırmak için kullanılabilir yöntemleri denetler. Uygun bir yöntem bulamazsa, giriş nesnelerinin ToString() yöntemlerini çağırır ve dize sonuçlarını karşılaştırır. Karşılaştırma için kullanılacak bir veya daha fazla özellik sağlayabilirsiniz. Özellikler sağlandığında, cmdlet yalnızca bu özelliklerin değerlerini karşılaştırır.
Karşılaştırmanın sonucu, bir özellik değerinin yalnızca başvuru nesnesinde mi (<=) yoksa yalnızca fark nesnesinde mi (=>) göründüğünü gösterir.
IncludeEqual parametresi kullanılırsa (==), değerin her iki nesnede de olduğunu gösterir.
başvuru veya fark nesneleri null ($null) ise Compare-Object sonlandırıcı bir hata oluşturur.
Bazı örneklerde kod örneklerinin satır uzunluğunu azaltmak için sıçrama kullanılır. Daha fazla bilgi için bkz. about_Splatting.
Parametreler
-CaseSensitive
Karşılaştırmaların büyük/küçük harfe duyarlı olması gerektiğini gösterir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Culture
Karşılaştırmalar için kullanılacak kültürü belirtir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DifferenceObject
başvuru nesnelerle karşılaştırılan nesneleri belirtir.
Parametre özellikleri
| Tür: | PSObject[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ExcludeDifferent
Bu cmdlet'in yalnızca eşit olan karşılaştırılan nesnelerin özelliklerini gösterdiğini gösterir. Nesneler arasındaki farklar atılır.
yalnızca
ExcludeDifferentIncludeEqualolmadan belirtilirse, çıkış yoktur.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-IncludeEqual
Varsayılan olarak çıkış,
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PassThru
PassThru parametresini kullandığınızda, Compare-ObjectPSCustomObject sarmalayıcısını karşılaştırılan nesnelerin çevresinde atlar ve değişmeden farklı nesneleri döndürür.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Property
Özelliği parametresinin değeri yeni bir hesaplanmış özellik olabilir. Hesaplanan özellik bir komut dosyası bloğu veya karma tablo olabilir. Geçerli anahtar-değer çiftleri şunlardır:
- İfade -
<string>veya<script block>
Daha fazla bilgi için, about_Calculated_Propertiesbölümüne bakın.
Parametre özellikleri
| Tür: | Object[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ReferenceObject
Karşılaştırma için başvuru olarak kullanılan bir nesne dizisini belirtir.
Parametre özellikleri
| Tür: | PSObject[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-SyncWindow
Bir nesne koleksiyonunda eşleşme ararken Compare-Object inceleyen bitişik nesnelerin sayısını belirtir.
Compare-Object, nesneyi bir koleksiyonda aynı konumda bulmadığında bitişik nesneleri inceler. Varsayılan değer [Int32]::MaxValuedeğeridir, yani Compare-Object nesne koleksiyonunun tamamını inceler.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | [Int32]::MaxValue |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
PSObject
bir nesneyi işlem hattından DifferenceObject parametresine gönderebilirsiniz.
Çıkışlar
None
Başvuru nesnesi ve difference nesnesi aynıysa, parametresini kullanmadığınız sürece IncludeEqual çıkış olmaz.
PSCustomObject
Nesneler farklıysa, Compare-Object farklara başvurmak için farklı nesneleri bir PSCustomObject sarmalayıcıda SideIndicator özelliğiyle sarmalar.
PassThru parametresini kullandığınızda, nesnenin Tür değiştirilmez, ancak döndürülen nesnenin örneğinde SideIndicatoradlı bir NoteProperty eklenmiştir. SideIndicator çıkışın hangi giriş nesnesine ait olduğunu gösterir.
Notlar
PassThru parametresi kullanılırken, konsolda görüntülenen çıkış SideIndicator özelliğini içermeyebilir. Nesne türü çıktısının Compare-Object varsayılan biçim görünümü SideIndicator özelliğini içermez. Daha fazla bilgi için bu makaledeki Örnek 3 bakın.