Unprotect-CmsMessage

参考

模块:: Microsoft.PowerShell.Security

使用加密消息语法格式解密已加密的内容。

语法

Unprotect-CmsMessage
         [-EventLogRecord] <PSObject>
         [-IncludeContext]
         [[-To] <CmsMessageRecipient[]>]
         [<CommonParameters>]

Unprotect-CmsMessage
         [-Content] <String>
         [-IncludeContext]
         [[-To] <CmsMessageRecipient[]>]
         [<CommonParameters>]

Unprotect-CmsMessage
         [-Path] <String>
         [-IncludeContext]
         [[-To] <CmsMessageRecipient[]>]
         [<CommonParameters>]

Unprotect-CmsMessage
         [-LiteralPath] <String>
         [-IncludeContext]
         [[-To] <CmsMessageRecipient[]>]
         [<CommonParameters>]

说明

Unprotect-CmsMessage cmdlet 解密已使用加密消息语法（CMS）格式加密的内容。

CMS cmdlet 支持使用 IETF 标准格式加密和解密内容，以加密方式保护消息，如 RFC5652所述。

CMS 加密标准使用公钥加密，其中用于加密内容的密钥（公钥）和用于解密内容的密钥（私钥）是分开的。公钥可以广泛共享，并且不是敏感数据。如果有任何内容使用此公钥进行加密，则只有私钥可以解密它。有关详细信息，请参阅公钥加密。

Unprotect-CmsMessage 解密已采用 CMS 格式加密的内容。可以通过运行 Protect-CmsMessage cmdlet 来解密已加密的内容。可以通过加密事件日志 ID 号或加密内容的路径指定要解密为字符串的内容。 Unprotect-CmsMessage cmdlet 返回解密的内容。

示例

示例 1：解密消息

PS C:\> C:\Users\gabyk\Documents\PowerShell_ISEUnprotect-CmsMessage -LiteralPath "C:\Users\Test\Documents\PowerShell ISE\Future_Plans.txt" -To '0f 8j b1 ab e0 ce 35 1d 67 d2 f2 6f a2 d2 00 cl 22 z9 m9 85'
Try the new Break All command

在以下示例中，解密位于文本路径 C：\Users\Test\Documents\PowerShell ISE 的内容。对于所需 To 参数的值，此示例使用用于执行加密的证书的指纹。解密的消息“尝试新的”全部中断命令“是结果。

参数

-Content

指定加密字符串或包含加密字符串的变量。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-EventLogRecord

指定表示 CMS 加密操作的事件日志 ID。

类型:	PSObject
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-IncludeContext

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LiteralPath

指定要解密的加密内容的路径。与路径不同，LiteralPath 的值与类型化完全相同。不会将任何字符解释为通配符。如果路径包含转义字符，请将它括在单引号中。单引号告知 Windows PowerShell 不要将任何字符解释为转义序列。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Path

指定要解密的加密内容的路径。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-To

指定一个或多个 CMS 消息收件人，以下列任何格式标识。

实际证书（从证书提供程序检索）。
包含证书的文件的路径。
包含证书的目录的路径。
证书的指纹（用于在证书存储中查找）。
证书的使用者名称（用于在证书存储中查找）。

类型:	CmsMessageRecipient[]
Position:	1
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

System.Diagnostics.Eventing.Reader.EventLogRecord or System.String

可以通过管道将包含加密内容的对象传递给 Unprotect-CmsMessage。

输出

String

未加密的消息。

通过