Unprotect-CmsMessage

  • Referencia
Modul:
Microsoft.PowerShell.Security

Visszafejti a titkosítással titkosított tartalmakat a titkosítási üzenet szintaxisának formátumával.

Syntax

Unprotect-CmsMessage
         [-EventLogRecord] <EventLogRecord>
         [[-To] <CmsMessageRecipient[]>]
         [-IncludeContext]
         [<CommonParameters>]
Unprotect-CmsMessage
         [-Content] <string>
         [[-To] <CmsMessageRecipient[]>]
         [-IncludeContext]
         [<CommonParameters>]
Unprotect-CmsMessage
         [-Path] <string>
         [[-To] <CmsMessageRecipient[]>]
         [-IncludeContext]
         [<CommonParameters>]
Unprotect-CmsMessage
         [-LiteralPath] <string>
         [[-To] <CmsMessageRecipient[]>]
         [-IncludeContext]
         [<CommonParameters>]

Description

A Unprotect-CmsMessage parancsmag visszafejti a titkosítási üzenet szintaxisa (CMS) formátummal titkosított tartalmakat.

A CMS-parancsmagok támogatják a tartalom titkosítását és visszafejtését az IETF szabványformátum használatával az üzenetek titkosítási védelme érdekében, ahogyan azt RFC5652 dokumentálta.

A CMS titkosítási szabvány nyilvános kulcsú titkosítást használ, ahol a tartalom titkosításához használt kulcsok (a nyilvános kulcs) és a tartalom visszafejtéséhez használt kulcsok (a titkos kulcs) külön vannak. A nyilvános kulcs széles körben megosztható, és nem bizalmas adatok. Ha bármely tartalom ezzel a nyilvános kulccsal van titkosítva, csak a titkos kulcs tudja visszafejteni. További információ: Nyilvános kulcsú titkosítás.

Unprotect-CmsMessage CMS formátumban titkosított tartalom visszafejtése. Ezt a parancsmagot futtatva visszafejtheti a titkosított tartalmakat a Protect-CmsMessage parancsmag futtatásával. Megadhatja a sztringként visszafejtendő tartalmat, a titkosítási eseménynapló rekordazonosítójának számát vagy a titkosított tartalom elérési útját. A Unprotect-CmsMessage parancsmag visszaadja a visszafejtett tartalmat.

A Linux és a macOS támogatása a PowerShell 7.1-ben lett hozzáadva.

Példák

1. példa: Üzenet visszafejtése

Az alábbi példában a literális elérési úton C:\Users\Test\Documents\PowerShelltalálható tartalom visszafejtése. A szükséges Paraméter értéke esetében ez a példa a titkosítás végrehajtásához használt tanúsítvány ujjlenyomatát használja. Az eredmény a visszafejtött "Az új Minden megszakítás parancs kipróbálása" üzenet.

$parameters = @{
  LiteralPath = "C:\Users\Test\Documents\PowerShell\Future_Plans.txt"
  To = '0f 8j b1 ab e0 ce 35 1d 67 d2 f2 6f a2 d2 00 cl 22 z9 m9 85'
}
Unprotect-CmsMessage -LiteralPath @parameters

Try the new Break All command

2. példa: Titkosított eseménynapló-üzenet visszafejtése

Az alábbi példa egy titkosított eseményt kap a PowerShell-eseménynaplóból, és visszafejti azt a használatával Unprotect-CmsMessage.

$event = Get-WinEvent Microsoft-Windows-PowerShell/Operational -MaxEvents 1 |
    Where-Object Id -eq 4104
Unprotect-CmsMessage -EventLogRecord $event

3. példa: Titkosított eseménynapló-üzenetek visszafejtése a folyamat használatával

Az alábbi példa lekéri az összes titkosított eseményt a PowerShell-eseménynaplóból, és visszafejti őket a használatával Unprotect-CmsMessage.

Get-WinEvent Microsoft-Windows-PowerShell/Operational |
    Where-Object Id -eq 4104 |
    Unprotect-CmsMessage

Paraméterek

-Content

Egy titkosított sztringet vagy egy titkosított sztringet tartalmazó változót határoz meg.

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

-EventLogRecord

Egy CMS-titkosított üzenetet tartalmazó eseménynapló-rekordot ad meg.

Type:PSObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IncludeContext

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Megadja a visszafejtendő titkosított tartalom elérési útját. A Path-tal ellentétben a LiteralPath értéke pontosan a beírt módon lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

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

-Path

Megadja a visszafejtendő titkosított tartalom elérési útját.

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

-To

Egy vagy több CMS-üzenet címzettjének megadása, amelyeket az alábbi formátumok bármelyike azonosít:

  • Tényleges tanúsítvány (a tanúsítványszolgáltatótól lekért módon).
  • A tanúsítványt tartalmazó fájl elérési útja.
  • A tanúsítványt tartalmazó könyvtár elérési útja.
  • A tanúsítvány ujjlenyomata (a tanúsítványtárolóban való kereséshez használatos).
  • A tanúsítvány tulajdonosának neve (a tanúsítványtárolóban való kereséshez használatos).
Type:CmsMessageRecipient[]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

EventLogRecord

String

Erre a parancsmagra titkosított tartalmat tartalmazó objektumot is csövezhet.

Kimenetek

String

Ez a parancsmag a titkosítatlan üzenetet adja vissza.