Delen via

Unprotect-CmsMessage

  • Referentie
Module:
Microsoft.PowerShell.Security

Ontsleutelt inhoud die is versleuteld met behulp van de indeling Cryptografische berichtsyntaxis.

Syntaxis

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>]

Description

De Unprotect-CmsMessage cmdlet ontsleutelt inhoud die is versleuteld met behulp van de CMS-indeling (Cryptographic Message Syntax).

De CMS-cmdlets ondersteunen versleuteling en ontsleuteling van inhoud met behulp van de IETF-standaardindeling 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-sleutelcryptografievoor meer informatie.

Unprotect-CmsMessage ontsleutelt inhoud die is versleuteld in CMS-indeling. U kunt deze cmdlet uitvoeren om inhoud te ontsleutelen die u hebt versleuteld door de Protect-CmsMessage cmdlet uit te voeren. U kunt inhoud opgeven die u wilt ontsleutelen als een tekenreeks, op basis van het id-nummer van de versleutelingslogboekrecord of op pad naar de versleutelde inhoud. De cmdlet Unprotect-CmsMessage retourneert de ontsleutelde inhoud.

Voorbeelden

Voorbeeld 1: Een bericht ontsleutelen

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

In het volgende voorbeeld ontsleutelt u inhoud die zich bevindt op het letterlijke pad C:\Users\Test\Documents\PowerShell ISE. Voor de waarde van de vereiste Voor parameter gebruikt dit voorbeeld de vingerafdruk van het certificaat dat is gebruikt om de versleuteling uit te voeren. 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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-EventLogRecord

Hiermee geeft u een gebeurtenislogboekrecord-id op die een CMS-versleutelingsbewerking vertegenwoordigt.

Type:PSObject
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-IncludeContext

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LiteralPath

Hiermee geeft u het pad naar versleutelde inhoud die u wilt ontsleutelen. In tegenstelling tot Pad, 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 het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven Windows PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad naar versleutelde inhoud die u wilt ontsleutelen.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-To

Hiermee geeft u een of meer CMS-berichtontvangers op, geïdentificeerd in een van de volgende indelingen.

  • Een echt certificaat (zoals opgehaald van de certificaatprovider).
  • Pad naar het bestand met het certificaat.
  • Pad naar een map met het certificaat.
  • Vingerafdruk van het certificaat (gebruikt om in het certificaatarchief te zoeken).
  • Onderwerpnaam van het certificaat (wordt gebruikt om in het certificaatarchief te zoeken).
Type:CmsMessageRecipient[]
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

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

U kunt een object met versleutelde inhoud doorsluisen naar Unprotect-CmsMessage.

Uitvoerwaarden

String

Het niet-versleutelde bericht.