Get-CmsMessage
Hiermee haalt u inhoud op die is versleuteld met behulp van de syntaxis van cryptografische berichten.
Syntax
Get-CmsMessage
[-Content] <String>
[<CommonParameters>]
Get-CmsMessage
[-Path] <String>
[<CommonParameters>]
Get-CmsMessage
[-LiteralPath] <String>
[<CommonParameters>]
Description
De Get-CmsMessage
cmdlet haalt inhoud op die is versleuteld met de CMS-indeling (Cryptographic Message Syntax).
De CMS-cmdlets ondersteunen versleuteling en ontsleuteling van inhoud met behulp van de IETF-indeling voor het cryptografisch beveiligen van berichten, zoals gedocumenteerd door RFC5652.
De CMS-versleutelingsstandaard maakt gebruik van openbare-sleutelcryptografie, waarbij de sleutels die worden gebruikt voor het versleutelen van inhoud (de openbare sleutel) en de sleutels voor het ontsleutelen van inhoud (de persoonlijke sleutel) gescheiden zijn. Uw openbare sleutel kan op grote schaal worden gedeeld en is geen gevoelige gegevens. Als inhoud is versleuteld met deze openbare sleutel, kan alleen uw persoonlijke sleutel deze ontsleutelen. Zie Cryptografie met openbare sleutels voor meer informatie.
Get-CmsMessage
haalt inhoud op die is versleuteld in CMS-indeling. De inhoud wordt niet ontsleuteld of de beveiliging ervan opheffen. U kunt deze cmdlet uitvoeren om inhoud op te halen die u hebt versleuteld door de Protect-CmsMessage
cmdlet uit te voeren. U kunt inhoud opgeven die u wilt ontsleutelen als een tekenreeks of per pad naar de versleutelde inhoud. U kunt de resultaten van Get-CmsMessage
doorsnijden naar Unprotect-CmsMessage
om de inhoud te ontsleutelen, op voorwaarde dat u informatie hebt over het certificaat voor documentversleuteling dat is gebruikt om de inhoud te versleutelen.
Ondersteuning voor Linux en macOS is toegevoegd in PowerShell 7.1.
Voorbeelden
Voorbeeld 1: versleutelde inhoud ophalen
$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-----
Met deze opdracht wordt versleutelde inhoud op C:\Users\Test\Documents\PowerShell\Future_Plans.txt.
Voorbeeld 2: versleutelde inhoud doorsnijden naar 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
Met deze opdracht worden de resultaten van de Get-CmsMessage
cmdlet van voorbeeld 1 doorvertaald naar Unprotect-CmsMessage
, om het bericht te ontsleutelen en in tekst zonder opmaak te lezen. In dit geval is de waarde van de parameter Aan de waarde van de onderwerpregel van het versleutelende certificaat. Het ontsleutelde bericht 'Probeer de nieuwe opdracht Alles verbreken' is het resultaat.
Parameters
-Content
Hiermee geeft u een versleutelde tekenreeks of een variabele die een versleutelde tekenreeks bevat.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Hiermee geeft u het pad naar versleutelde inhoud die u wilt ophalen. In tegenstelling tot Path wordt de waarde van LiteralPath exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u deze tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat ingesloten tekens niet als escapetekens moeten worden geïnterpreteerd.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Hiermee geeft u het pad naar versleutelde inhoud dat u wilt ontsleutelen.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |