Get-CmsMessage

  • Referencia
Modul:
Microsoft.PowerShell.Security

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

Syntax

Get-CmsMessage
   [-Content] <String>
   [<CommonParameters>]
Get-CmsMessage
   [-Path] <String>
   [<CommonParameters>]
Get-CmsMessage
   [-LiteralPath] <String>
   [<CommonParameters>]

Description

A Get-CmsMessage parancsmag lekéri a titkosítási üzenet szintaxisa (CMS) formátumával titkosított tartalmat.

A CMS-parancsmagok támogatják a tartalom titkosítását és visszafejtését az üzenetek titkosítási védelme érdekében az IETF formátum használatával, ahogyan azt a 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.

Get-CmsMessage CMS formátumban titkosított tartalmat kap. Nem fejti vissza és nem oldja fel a tartalom védelmét. A parancsmag futtatásával lekérheti a Protect-CmsMessage titkosított tartalmakat. Megadhatja a sztringként visszafejtendő tartalmat, vagy a titkosított tartalom elérési útja alapján. Az eredmények Get-CmsMessageUnprotect-CmsMessage alapján visszafejtheti a tartalmat, feltéve, hogy rendelkezik a tartalom titkosításához használt dokumentumtitkosítási tanúsítvánnyal.

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

Példák

1. példa: Titkosított tartalom lekérése

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

Ez a parancs a C:\Users\Test\Documents\PowerShell\Future_Plans.txt címen található titkosított tartalmat kapja meg.

2. példa: Titkosított tartalom pipálása a Unprotect-CmsMessage-be

$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

Ez a parancs a parancsmag eredményeit az Get-CmsMessage 1. példából a következőbe irányítja az üzenet visszafejtéséhez és egyszerű szövegben való olvasásához Unprotect-CmsMessage. Ebben az esetben a To paraméter értéke a titkosító tanúsítvány Tárgy sorának értéke. Az eredmény a visszafejtött "Az új Minden megszakítás parancs kipróbálása" üzenet.

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

-LiteralPath

Megadja a lekérni kívánt titkosított tartalom elérési útját. Az elérési úttal 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 feloldó karaktereket, mindegyik egy-egy idézőjelbe van foglalva. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezze a zárt karaktereket escape karakterként.

Type:String
Position:1
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:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False