Delen via

Get-CmsMessage

  • Referentie
Module:
Microsoft.PowerShell.Security

Hiermee haalt u inhoud op die is versleuteld met behulp van de indeling Cryptografische berichtsyntaxis.

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 beschreven door RFC5652.

De CMS-versleutelingsstandaard maakt gebruik van cryptografie van openbare sleutels, waarbij de sleutels die worden gebruikt voor het versleutelen van inhoud (de openbare sleutel) en de sleutels die worden gebruikt om inhoud (de persoonlijke sleutel) te ontsleutelen, gescheiden zijn. Uw openbare sleutel kan op grote schaal worden gedeeld en zijn geen gevoelige gegevens. Als inhoud met deze openbare sleutel is versleuteld, kan alleen uw persoonlijke sleutel deze ontsleutelen. Zie Openbare-sleutelcryptografie voor meer informatie.

Get-CmsMessage haalt inhoud op die is versleuteld in CMS-indeling. De inhoud wordt niet ontsleuteld of ontsleuteld. U kunt deze cmdlet uitvoeren om inhoud op te halen die u hebt versleuteld door de cmdlet uit te Protect-CmsMessage voeren. U kunt inhoud opgeven die u wilt ontsleutelen als een tekenreeks of per pad naar de versleutelde inhoud. U kunt de resultaten Get-CmsMessage doorsluisen om de inhoud te Unprotect-CmsMessage ontsleutelen, mits 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 opgeslagen op C:\Users\Test\Documents\PowerShell\Future_Plans.txt.

Voorbeeld 2: Versleutelde inhoud doorsluisen naar Beveiliging cmsMessage opheffen

$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 naar Unprotect-CmsMessageuitgevoerd, 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 versleutelingscertificaat. Het ontsleutelde bericht 'Probeer de nieuwe opdracht Alles verbreken' is het resultaat.

Parameters

-Content

Hiermee geeft u een versleutelde tekenreeks of een variabele met een versleutelde tekenreeks op.

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 het pad wordt de waarde van LiteralPath precies 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 die u wilt ontsleutelen.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False