Unprotect-CmsMessage

Modul:

Microsoft.PowerShell.Security Module

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

Syntax

ByWinEvent (Alapértelmezett)

Unprotect-CmsMessage
    [-EventLogRecord] <EventLogRecord>
    [[-To] <CmsMessageRecipient[]>]
    [-IncludeContext]
    [<CommonParameters>]

ByContent

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

ByPath

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

ByLiteralPath

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 RFC5652dokumentá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ási.

Unprotect-CmsMessage CMS formátumban titkosított tartalmak visszafejtése. Futtathatja ezt a parancsmagot a tartalmak visszafejtéséhez, amelyeket a Protect-CmsMessage parancsmag futtatásával titkosított. 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 egy C:\Users\Test\Documents\PowerShellliterális elérési úton található tartalmat fejtesz vissza. A szükséges paraméter értékéhez 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 visszafejtett üzenet: "Próbáld ki az új Összes törlése parancsot."

$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 Unprotect-CmsMessagehasználatával.

$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 Unprotect-CmsMessagehasználatával.

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.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ByContent

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-EventLogRecord

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

Paramétertulajdonságok

Típus:	PSObject
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ByWinEvent

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-IncludeContext

Meghatározza, hogy a visszafejtött tartalom szerepeljen-e az eredeti környezetében ahelyett, hogy csak a visszafejtett tartalmat adja ki.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-LiteralPath

Megadja a visszafejtendő titkosított tartalom elérési útját. A Elérési úttalellentétben a LiteralPath értéke pontosan úgy van használva, ahogy be van írva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ByLiteralPath

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Path

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

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ByPath

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-To

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

• Egy 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).

Paramétertulajdonságok

Típus:	CmsMessageRecipient[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	1
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

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.

Kapcsolódó hivatkozások

• A szolgáltatókról
• Get-CmsMessage
• Protect-CmsMessage