Compartir a través de

Get-CmsMessage

  • Referencia
Módulo:
Microsoft.PowerShell.Security

Obtiene el contenido que se ha cifrado mediante el formato de sintaxis de mensajes criptográficos.

Sintaxis

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

Description

El cmdlet Get-CmsMessage obtiene contenido que se ha cifrado mediante el formato de sintaxis de mensajes criptográficos (CMS).

Los cmdlets de CMS admiten el cifrado y el descifrado del contenido mediante el formato IETF para proteger los mensajes criptográficamente, tal como se documenta en RFC5652.

El estándar de cifrado cmS usa criptografía de clave pública, donde las claves usadas para cifrar el contenido (la clave pública) y las claves usadas para descifrar contenido (la clave privada) son independientes. La clave pública se puede compartir ampliamente y no es información confidencial. Si algún contenido se cifra con esta clave pública, solo la clave privada puede descifrarlo. Para obtener más información, vea criptografía de clave pública.

Get-CmsMessage obtiene contenido cifrado en formato CMS. No descifra ni desprotege contenido. Puede ejecutar este cmdlet para obtener el contenido que ha cifrado mediante la ejecución del cmdlet Protect-CmsMessage. Puede especificar el contenido que desea descifrar como una cadena o por ruta de acceso al contenido cifrado. Puede canalizar los resultados de Get-CmsMessage para Unprotect-CmsMessage descifrar el contenido, siempre que tenga información sobre el certificado de cifrado de documentos que se usó para cifrar el contenido.

Se ha agregado compatibilidad con Linux y macOS en PowerShell 7.1.

Ejemplos

Ejemplo 1: Obtener contenido cifrado

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

Este comando obtiene contenido cifrado ubicado en C:\Users\Test\Documents\PowerShell\Future_Plans.txt.

Ejemplo 2: Canalización del contenido cifrado a 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

Este comando canaliza los resultados del cmdlet Get-CmsMessage del ejemplo 1 al Unprotect-CmsMessage, para descifrar el mensaje y leerlo en texto sin formato. En este caso, el valor del parámetro To es el valor de la línea Asunto del certificado de cifrado. El mensaje descifrado " Try the new Break All command" (Probar el nuevo comando Interrumpir todo) es el resultado.

Parámetros

-Content

Especifica una cadena cifrada o una variable que contiene una cadena cifrada.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-LiteralPath

Especifica la ruta de acceso al contenido cifrado que desea obtener. A diferencia de Ruta de acceso, el valor de LiteralPath se usa exactamente como se escribe. No se interpreta ningún carácter comodín. Si la ruta de acceso incluye caracteres de escape, encierre cada uno entre comillas simples. Las comillas simples indican a PowerShell que no interprete los caracteres incluidos como caracteres de escape.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso al contenido cifrado que desea descifrar.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False