Get-CmsMessage
Şifreleme İletisi Söz Dizimi biçimi kullanılarak şifrelenmiş içeriği alır.
Sözdizimi
ByContent
Get-CmsMessage
[-Content] <String>
[<CommonParameters>]
ByPath
Get-CmsMessage
[-Path] <String>
[<CommonParameters>]
ByLiteralPath
Get-CmsMessage
[-LiteralPath] <String>
[<CommonParameters>]
Description
Get-CmsMessage cmdlet'i, Kriptografik Mesaj Söz Dizimi (CMS) formatında şifrelenmiş içeriği elde eder.
CMS cmdlet'leri, RFC5652tarafından belgelendiği gibi iletileri şifrelemek için IETF biçimini kullanarak içeriğin şifrelenmesini ve şifre çözmesini destekler.
CMS şifreleme standardı, içeriği şifrelemek için kullanılan anahtarların (ortak anahtar) ve içeriğin şifresini çözmek için kullanılan anahtarların (özel anahtar) ayrı olduğu ortak anahtar şifrelemesini kullanır. Ortak anahtarınız yaygın olarak paylaşılabilir ve hassas veriler değildir. Herhangi bir içerik bu ortak anahtarla şifrelenirse, yalnızca özel anahtarınız şifreyi çözebilir. Daha fazla bilgi için bkz. ortak anahtar şifreleme
Get-CmsMessage, CMS biçiminde şifrelenmiş içeriği alır. İçeriğin şifresini çözmez veya korumasını kaldırmaz.
Protect-CmsMessage cmdlet'ini çalıştırarak şifrelediğiniz içeriği almak için bu cmdlet'i çalıştırabilirsiniz. Şifrelerini çözmek istediğiniz içeriği dize olarak veya şifrelenmiş içeriğin yoluna göre belirtebilirsiniz. İçeriği şifrelemek için kullanılan belge şifreleme sertifikası hakkında bilginiz olması koşuluyla, içeriğin şifresini çözmek için Get-CmsMessage sonuçlarını Unprotect-CmsMessage aktarabilirsiniz.
PowerShell 7.1'de Linux ve macOS desteği eklendi.
Örnekler
Örnek 1: Şifrelenmiş içerik alma
$Msg = Get-CmsMessage -Path "C:\Users\Test\Documents\PowerShell\Future_Plans.txt"
$Msg.Content
-----BEGIN CMS-----
MIIBqAYJKoZIhvcNAQcDoIIBmTCCAZUCAQAxggFQMIIBTAIBADA0MCAxHjAcBgNVBAMBFWxlZWhv
bG1AbGljcm9zb2Z0LmNvbQIQQYHsbcXnjIJCtH+OhGmc1DANBgkqhkiG9w0BAQcwAASCAQAnkFHM
proJnFy4geFGfyNmxH3yeoPvwEYzdnsoVqqDPAd8D3wao77z7OhJEXwz9GeFLnxD6djKV/tF4PxR
E27aduKSLbnxfpf/sepZ4fUkuGibnwWFrxGE3B1G26MCenHWjYQiqv+Nq32Gc97qEAERrhLv6S4R
G+2dJEnesW8A+z9QPo+DwYP5FzD0Td0ExrkswVckpLNR6j17Yaags3ltNXmbdEXekhi6Psf2MLMP
TSO79lv2L0KeXFGuPOrdzPRwCkV0vNEqTEBeDnZGrjv/5766bM3GW34FXApod9u+VSFpBnqVOCBA
DVDraA6k+xwBt66cV84AHLkh0kT02SIHMDwGCSqGSIb3DQEHATAdBglghkgBZQMEASoEEJbJaiRl
KMnBoD1dkb/FzSWAEBaL8xkFwCu0e1AtDj7nSJc=
-----END CMS-----
Bu komut, C:\Users\Test\Documents\PowerShell\Future_Plans.txtkonumunda bulunan şifrelenmiş içeriği alır.
Örnek 2: Şifrelenmiş içeriği Unprotect-CmsMessage'a gönder
$Msg = Get-CmsMessage -Path "C:\Users\Test\Documents\PowerShell\Future_Plans.txt"
$Msg | Unprotect-CmsMessage -To "cn=youralias@emailaddress.com"
Try the new Break All command
Bu komut, iletinin şifresini çözmek ve düz metin olarak okunmasını sağlamak için Örnek 1'den Get-CmsMessage cmdlet'inin sonuçlarını Unprotect-CmsMessage'e aktarır. Bu durumda, ile parametresinin değeri, şifreleme sertifikasının Konu satırının değeridir. Şifresi çözülen ileti, "Yeni Tümünü Kes komutunu deneyin," olarak sonuçlanır.
Parametreler
-Content
Şifrelenmiş bir dizeyi veya şifrelenmiş dize içeren bir değişkeni belirtir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ByContent
| Position: | 0 |
| 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 |
-LiteralPath
Almak istediğiniz şifrelenmiş içeriğin yolunu belirtir. Path'in aksine, LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterlerini içeriyorsa, her bir kaçış karakterini tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e kapalı karakterleri kaçış karakterleri olarak yorumlamaması gerektiğini söyler.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ByLiteralPath
| Position: | 1 |
| 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 |
-Path
Şifresini çözmek istediğiniz şifrelenmiş içeriğin yolunu belirtir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ByPath
| Position: | 1 |
| 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 |
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.
