Get-FileHash
Belirtilen karma algoritmasını kullanarak bir dosyanın karma değerini hesaplar.
Sözdizimi
Path EnterprisePublishing
Get-FileHash
[-Path] <String[]>
[[-Algorithm] <String>]
[<CommonParameters>]
LiteralPath
Get-FileHash
[-LiteralPath] <String[]>
[[-Algorithm] <String>]
[<CommonParameters>]
StreamParameterSet
Get-FileHash
[-InputStream] <Stream>
[[-Algorithm] <String>]
[<CommonParameters>]
Description
Get-FileHash cmdlet'i, belirtilen karma algoritmasını kullanarak bir dosyanın karma değerini hesaplar.
Karma değer, dosyanın içeriğine karşılık gelen benzersiz bir değerdir. Karma, dosyanın içeriğini dosya adı, uzantısı veya başka bir adla tanımlamak yerine, dosyanın içeriğine benzersiz bir değer atar. Dosya adları ve uzantıları, dosyanın içeriği değiştirilmeden ve karma değeri değiştirilmeden değiştirilebilir. Benzer şekilde, dosyanın içeriği ad veya uzantı değiştirilmeden değiştirilebilir. Ancak, bir dosyanın içeriğindeki tek bir karakterin bile değiştirilmesi, dosyanın karma değerini değiştirir.
Karma değerlerin amacı, dosyanın içeriğinin değiştirilmediğini doğrulamak için şifreleme açısından güvenli bir yol sağlamaktır. MD5 ve SHA1 dahil olmak üzere bazı karma algoritmalar artık saldırılara karşı güvenli olarak kabul edilmese de, güvenli karma algoritmasının amacı bir dosyanın içeriğini (yanlışlıkla veya kötü amaçlı ya da yetkisiz girişimle) değiştirmeyi ve aynı karma değerini korumayı imkansız hale getirmektir. İki farklı dosyada tam olarak aynı içeriğe sahip olup olmadığını belirlemek için karma değerleri de kullanabilirsiniz. İki dosyanın karma değerleri aynıysa, dosyaların içeriği de aynıdır.
Varsayılan olarak, Get-FileHash cmdlet'i SHA256 algoritmasını kullanır, ancak hedef işletim sistemi tarafından desteklenen karma algoritmalar kullanılabilir.
Örnekler
Örnek 1: Bir dosyanın karma değerini hesaplama
Bu örnek, Get-FileHash dosyasının karma değerini hesaplamak için /etc/apt/sources.list cmdlet'ini kullanır. Kullanılan karma algoritması sha256 varsayılandır. Çıkış, çıkışı liste olarak biçimlendirmek için Format-List cmdlet'ine yöneltilir.
Get-FileHash /etc/apt/sources.list | Format-List
Algorithm : SHA256
Hash : 3CBCFDDEC145E3382D592266BE193E5BE53443138EE6AB6CA09FF20DF609E268
Path : /etc/apt/sources.list
Örnek 2: ISO dosyasının karma değerini hesaplama
Bu örnekte, bir yöneticinin İnternet'ten indirdiği ISO dosyasının karma değerini hesaplamak için Get-FileHash cmdlet'i ve SHA384 algoritması kullanılır. Çıkış, çıkışı liste olarak biçimlendirmek için Format-List cmdlet'ine yöneltilir.
Get-FileHash C:\Users\user1\Downloads\Contoso8_1_ENT.iso -Algorithm SHA384 | Format-List
Algorithm : SHA384
Hash : 20AB1C2EE19FC96A7C66E33917D191A24E3CE9DAC99DB7C786ACCE31E559144FEAFC695C58E508E2EBBC9D3C96F21FA3
Path : C:\Users\user1\Downloads\Contoso8_1_ENT.iso
Örnek 3: Akışın karma değerini hesaplama
Bu örnekte, PowerShell sürüm sayfasındanbir paket indirmek için System.Net.WebClient kullanıyoruz. Yayın sayfasında ayrıca her paket dosyasının SHA256 karması da belgelenmiştir. Yayımlanan karma değerini Get-FileHashile hesapladığımız değerle karşılaştırabiliriz.
$wc = [System.Net.WebClient]::new()
$baseurl = 'https://github.com/PowerShell/PowerShell/releases/download/v6.2.4/'
$pkgname = 'powershell_6.2.4-1.debian.9_amd64.deb'
$pkgurl = $baseurl + $pkgname
$publishedHash = '8E28E54D601F0751922DE24632C1E716B4684876255CF82304A9B19E89A9CCAC'
$FileHash = Get-FileHash -InputStream ($wc.OpenRead($pkgurl))
$FileHash.Hash -eq $publishedHash
True
Örnek 4: Bir dizenin karması hesaplanır
PowerShell, bir dizenin karması hesaplamak için bir cmdlet sağlamaz. Ancak, bir akışa dize yazabilir ve karma değerini almak için Get-FileHash parametresini kullanabilirsiniz.
$stringAsStream = [System.IO.MemoryStream]::new()
$writer = [System.IO.StreamWriter]::new($stringAsStream)
$writer.Write("Hello world")
$writer.Flush()
$stringAsStream.Position = 0
Get-FileHash -InputStream $stringAsStream | Select-Object Hash
Hash
----
64EC88CA00B268E5BA1A35678A1B5316D212F4F366B2477232534A8AECA37F3C
Parametreler
-Algorithm
Belirtilen dosya veya akışın içeriğinin karma değerini hesaplamada kullanılacak şifreleme karma işlevini belirtir. Şifreleme karma işlevi, aynı karma değerine sahip iki farklı dosyayı bulmanın mümkün olduğu özelliğine sahiptir. Karma işlevler genellikle dijital imzalarla ve veri bütünlüğü için kullanılır. Bu parametre için kabul edilebilir değerler şunlardır:
- SHA1
- SHA256
- SHA384
- SHA512
- MD5
Değer belirtilmezse veya parametre atlanırsa, varsayılan değer SHA256'dır.
Güvenlik nedeniyle, artık güvenli kabul edilmeyen MD5 ve SHA1 yalnızca basit değişiklik doğrulaması için kullanılmalı ve saldırı veya kurcalamaya karşı koruma gerektiren dosyalar için karma değerler oluşturmak için kullanılmamalıdır.
Parametre özellikleri
| Tür: | String |
| Default value: | SHA256 |
| Kabul edilen değerler: | SHA1, SHA256, SHA384, SHA512, MD5 |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| 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 |
-InputStream
Giriş akışını belirtir.
Parametre özellikleri
| Tür: | Stream |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
StreamParameterSet
| 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 |
-LiteralPath
Dosyanın yolunu belirtir. Path parametresinden farklı olarak, LiteralPath parametresinin değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, yolu tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e karakterleri kaçış dizisi olarak yorumlamamasını belirtir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath, LP |
Parametre kümeleri
LiteralPath
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Dizi olarak bir veya daha fazla dosya yolunu belirtir. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
Path
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| 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
String
Bir dosyanın yolunu içeren bir dizeyi bu cmdlet'e aktarabilirsiniz.
Çıkışlar
Microsoft.PowerShell.Utility.FileHash
Bu cmdlet, belirtilen dosyanın yolunu, hesaplanan karmanın değerini ve karmayı hesaplamak için kullanılan algoritmayı temsil eden bir nesne döndürür.
