Get-CmsMessage
Získá obsah, který byl zašifrován pomocí kryptografického formátu syntaxe zprávy.
Syntax
ByContent
Get-CmsMessage
[-Content] <String>
[<CommonParameters>]
ByPath
Get-CmsMessage
[-Path] <String>
[<CommonParameters>]
ByLiteralPath
Get-CmsMessage
[-LiteralPath] <String>
[<CommonParameters>]
Description
Rutina Get-CmsMessage získá obsah, který byl šifrovaný pomocí formátu Cryptographic Message Syntax (CMS).
Rutiny CMS podporují šifrování a dešifrování obsahu pomocí formátu IETF pro kryptograficky chráněné zprávy, jak je zdokumentované RFC5652.
Šifrovací standard CMS používá kryptografii veřejného klíče, kde jsou klíče používané k šifrování obsahu (veřejného klíče) a klíče používané k dešifrování obsahu (privátního klíče) oddělené. Váš veřejný klíč je možné sdílet široce a nejedná se o citlivá data. Pokud je jakýkoli obsah zašifrovaný tímto veřejným klíčem, může ho dešifrovat jenom váš privátní klíč. Další informace naleznete v tématu kryptografie veřejného klíče.
Get-CmsMessage získá obsah šifrovaný ve formátu CMS. Nešifruje ani nechrání obsah. Spuštěním této rutiny můžete získat obsah, který jste zašifrovali spuštěním rutiny Protect-CmsMessage. Můžete zadat obsah, který chcete dešifrovat jako řetězec, nebo cestou k šifrovaného obsahu. Výsledky Get-CmsMessage můžete převést na Unprotect-CmsMessage k dešifrování obsahu za předpokladu, že máte informace o šifrovacím certifikátu dokumentu, který se použil k šifrování obsahu.
Příklady
Příklad 1: Získání šifrovaného obsahu
PS C:\> Get-CmsMessage -Path "C:\Users\Test\Documents\PowerShell ISE\Future_Plans.txt"
-----BEGIN CMS-----
MIIBqAYJKoZIhvcNAQcDoIIBmTCCAZUCAQAxggFQMIIBTAIBADA0MCAxHjAcBgNVBAMBFWxlZWhv
bG1AbGljcm9zb2Z0LmNvbQIQQYHsbcXnjIJCtH+OhGmc1DANBgkqhkiG9w0BAQcwAASCAQAnkFHM
proJnFy4geFGfyNmxH3yeoPvwEYzdnsoVqqDPAd8D3wao77z7OhJEXwz9GeFLnxD6djKV/tF4PxR
E27aduKSLbnxfpf/sepZ4fUkuGibnwWFrxGE3B1G26MCenHWjYQiqv+Nq32Gc97qEAERrhLv6S4R
G+2dJEnesW8A+z9QPo+DwYP5FzD0Td0ExrkswVckpLNR6j17Yaags3ltNXmbdEXekhi6Psf2MLMP
TSO79lv2L0KeXFGuPOrdzPRwCkV0vNEqTEBeDnZGrjv/5766bM3GW34FXApod9u+VSFpBnqVOCBA
DVDraA6k+xwBt66cV84AHLkh0kT02SIHMDwGCSqGSIb3DQEHATAdBglghkgBZQMEASoEEJbJaiRl
KMnBoD1dkb/FzSWAEBaL8xkFwCu0e1AtDj7nSJc=
-----END CMS-----
Tento příkaz získá šifrovaný obsah umístěný v C:\Users\Test\Documents\PowerShell\ISE\Future_Plans.txt.
Příklad 2: Přesměrovat zašifrovaný obsah do Unprotect-CmsMessage
PS C:\> $Msg = Get-CmsMessage -Path "C:\Users\Test\Documents\PowerShell ISE\Future_Plans.txt"
$Msg | Unprotect-CmsMessage -To "cn=youralias@emailaddress.com"
Try the new Break All command
Tento příkaz předá výsledky rutiny Get-CmsMessage z příkladu 1 do Unprotect-CmsMessage, dešifruje zprávu a přečte ji ve formátu prostého textu. V tomto případě je hodnota parametru To hodnota řádku Předmět zašifrujícího certifikátu. Dešifrovaná zpráva Try the new Break All command (Vyzkoušet nový příkaz Break All) je výsledkem.
Parametry
-Content
Určuje šifrovaný řetězec nebo proměnnou obsahující šifrovaný řetězec.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ByContent
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje cestu k šifrovaného obsahu, který chcete získat. Na rozdíl od cestyse hodnota LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje escape znaky, uzavřete každý z nich do jednoduchých uvozovek. Jednoduché uvozovky říkají prostředí Windows PowerShell, aby neukládal uzavřené znaky jako řídicí znaky.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ByLiteralPath
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje cestu k šifrovaného obsahu, který chcete dešifrovat.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ByPath
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.