Get-CmsMessage
Ruft Inhalte ab, die mit dem Format kryptografische Nachrichtensyntax verschlüsselt wurden.
Syntax
Get-CmsMessage
[-Content] <String>
[<CommonParameters>]
Get-CmsMessage
[-Path] <String>
[<CommonParameters>]
Get-CmsMessage
[-LiteralPath] <String>
[<CommonParameters>]
Beschreibung
Das Get-CmsMessage
Cmdlet ruft Inhalte ab, die mit dem CMS-Format (Cryptographic Message Syntax) verschlüsselt wurden.
Die CMS-Cmdlets unterstützen die Ver- und Entschlüsselung von Inhalten mit dem IETF-Format zum kryptografischen Schutz von Nachrichten, wie von RFC5652 dokumentiert.
Der CMS-Verschlüsselungsstandard verwendet Kryptografie mit öffentlichen Schlüsseln, bei der die Zum Verschlüsseln von Inhalten verwendeten Schlüssel (der öffentliche Schlüssel) und die Zum Entschlüsseln von Inhalten verwendeten Schlüssel (der private Schlüssel) getrennt sind. Ihr öffentlicher Schlüssel kann umfassend freigegeben werden, da seine Daten nicht vertraulich sind. Wenn Inhalte mit diesem öffentlichen Schlüssel verschlüsselt sind, können sie nur mit Ihrem privaten Schlüssel entschlüsselt werden. Weitere Informationen finden Sie unter Public-Key-Verschlüsselungsverfahren.
Get-CmsMessage
ruft Inhalte ab, die im CMS-Format verschlüsselt wurden. Der Schutz von Inhalten wird nicht entschlüsselt oder aufgehoben. Sie können dieses Cmdlet ausführen, um verschlüsselte Inhalte abzurufen, indem Sie das Protect-CmsMessage
Cmdlet ausführen. Sie können Inhalte, die Sie entschlüsseln möchten, als Zeichenfolge oder als Pfad zum verschlüsselten Inhalt angeben. Sie können die Ergebnisse von Get-CmsMessage
an Unprotect-CmsMessage
übergeben, um den Inhalt zu entschlüsseln, vorausgesetzt, Sie verfügen über Informationen zum Dokumentverschlüsselungszertifikat, das zum Verschlüsseln des Inhalts verwendet wurde.
Hinweis
Dieses Cmdlet ist nur unter Windows verfügbar.
Beispiele
Beispiel 1: Abrufen verschlüsselter Inhalte
$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-----
Dieser Befehl ruft verschlüsselte Inhalte ab, die sich unter C:\Users\Test\Documents\PowerShell\Future_Plans.txt befinden.
Beispiel 2: Übergeben von verschlüsselten Inhalten an 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
Dieser Befehl leitet die Ergebnisse des Get-CmsMessage
Cmdlets aus Beispiel 1 an weiter Unprotect-CmsMessage
, um die Nachricht zu entschlüsseln und als Nur-Text zu lesen. In diesem Fall ist der Wert des To-Parameters der Wert der Betreffzeile des verschlüsselnden Zertifikats. Die entschlüsselte Meldung "Try the new Break All command" ist das Ergebnis.
Parameter
-Content
Gibt eine verschlüsselte Zeichenfolge oder eine Variable an, die eine verschlüsselte Zeichenfolge enthält.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Gibt den Pfad zu verschlüsselten Inhalten an, den Sie abrufen möchten. Im Gegensatz zu Path wird der Wert von LiteralPath genau so verwendet, wie er eingegeben wurde. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie jedes in einfache Anführungszeichen ein. Einfache Anführungszeichen weisen PowerShell an, eingeschlossene Zeichen nicht als Escapezeichen zu interpretieren.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Gibt den Pfad zu verschlüsseltem Inhalt an, den Sie entschlüsseln möchten.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.