Get-CmsMessage

  • Referensi
Modul:
Microsoft.PowerShell.Security

Mendapatkan konten yang telah dienkripsi dengan menggunakan format Sintaks Pesan Kriptografi.

Sintaks

Get-CmsMessage
   [-Content] <String>
   [<CommonParameters>]
Get-CmsMessage
   [-Path] <String>
   [<CommonParameters>]
Get-CmsMessage
   [-LiteralPath] <String>
   [<CommonParameters>]

Deskripsi

Get-CmsMessage Cmdlet mendapatkan konten yang telah dienkripsi menggunakan format Sintaks Pesan Kriptografi (CMS).

Cmdlet CMS mendukung enkripsi dan dekripsi konten menggunakan format IETF untuk melindungi pesan secara kriptografis, seperti yang didokumentasikan oleh RFC5652.

Standar enkripsi CMS menggunakan kriptografi kunci publik, di mana kunci yang digunakan untuk mengenkripsi konten (kunci publik) dan kunci yang digunakan untuk mendekripsi konten (kunci privat) terpisah. Kunci publik Anda dapat dibagikan secara luas, dan bukan data sensitif. Jika ada konten yang dienkripsi dengan kunci publik ini, hanya kunci privat Anda yang dapat mendekripsinya. Untuk informasi selengkapnya, lihat Kriptografi kunci publik.

Get-CmsMessage mendapatkan konten yang telah dienkripsi dalam format CMS. Ini tidak mendekripsi atau membatalkan perlindungan konten. Anda dapat menjalankan cmdlet ini untuk mendapatkan konten yang telah Anda enkripsi dengan menjalankan Protect-CmsMessage cmdlet. Anda dapat menentukan konten yang ingin Didekripsi sebagai string, atau berdasarkan jalur ke konten terenkripsi. Anda dapat menyalurkan hasil untuk Unprotect-CmsMessage mendekripsi Get-CmsMessage konten, asalkan Anda memiliki informasi tentang sertifikat enkripsi dokumen yang digunakan untuk mengenkripsi konten.

Dukungan untuk Linux dan macOS ditambahkan di PowerShell 7.1.

Contoh

Contoh 1: Mendapatkan konten terenkripsi

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

Perintah ini mendapatkan konten terenkripsi yang terletak di C:\Users\Test\Documents\PowerShell\Future_Plans.txt.

Contoh 2: Pipa konten terenkripsi ke Unprotect-CmsMessage

$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

Perintah ini menyalurkan hasil Get-CmsMessage cmdlet dari Contoh 1 ke Unprotect-CmsMessage, untuk mendekripsi pesan dan membacanya dalam teks biasa. Dalam hal ini, nilai parameter Kepada adalah nilai baris Subjek sertifikat enkripsi. Pesan yang didekripsi, "Coba perintah Break All baru," adalah hasilnya.

Parameter

-Content

Menentukan string terenkripsi, atau variabel yang berisi string terenkripsi.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Menentukan jalur ke konten terenkripsi yang ingin Anda dapatkan. Tidak seperti Path, nilai LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai karakter kartubebas. Jika jalur menyertakan karakter escape, sertakan masing-masing dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter yang diapit sebagai karakter escape.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

Menentukan jalur ke konten terenkripsi yang ingin Anda dekripsi.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False