Bagikan melalui

Get-CmsMessage

Modul:
Microsoft.PowerShell.Security Module

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

Sintaks

ByContent 

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

ByPath 

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

ByLiteralPath 

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

Deskripsi

cmdlet Get-CmsMessage 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 cmdlet Protect-CmsMessage. Anda dapat menentukan konten yang ingin Didekripsi sebagai string, atau berdasarkan jalur ke konten terenkripsi. Anda dapat menyalurkan hasil Get-CmsMessage ke Unprotect-CmsMessage untuk mendekripsi 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: Salurkan 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 cmdlet Get-CmsMessage dari Contoh 1 ke Unprotect-CmsMessage, untuk mendekripsi pesan dan membacanya dalam teks biasa. Dalam hal ini, nilai parameter To 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.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

ByContent
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-LiteralPath

Menentukan jalur ke konten terenkripsi yang ingin Anda dapatkan. Tidak seperti Path, nilai LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai karakter pengganti. Jika jalur menyertakan karakter escape, apit masing-masing dengan tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menafsirkan karakter yang diapit sebagai karakter pelolosan.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

ByLiteralPath
Position:1
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Path

Menentukan jalur ke konten terenkripsi yang ingin Anda dekripsi.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

ByPath
Position:1
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.