Unprotect-CmsMessage
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\PowerShell
talá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.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-EventLogRecord
Egy CMS-titkosított üzenetet tartalmazó eseménynapló-rekordot ad meg.
Típus: | PSObject |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-IncludeContext
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Path
Megadja a visszafejtendő titkosított tartalom elérési útját.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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).
Típus: | CmsMessageRecipient[] |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
Erre a parancsmagra titkosított tartalmat tartalmazó objektumot is csövezhet.
Kimenetek
Ez a parancsmag a titkosítatlan üzenetet adja vissza.