Get-CmsMessage
Lekéri a titkosítással titkosított tartalmakat a titkosítási üzenet szintaxisának formátumával.
Syntax
ByContent
Get-CmsMessage
[-Content] <String>
[<CommonParameters>]
ByPath
Get-CmsMessage
[-Path] <String>
[<CommonParameters>]
ByLiteralPath
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 RFC5652.
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.
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 titkosított tartalmakat a Protect-CmsMessage parancsmag futtatásával. Megadhatja a sztringként visszafejtendő tartalmat, vagy a titkosított tartalom elérési útja alapján. A Get-CmsMessage eredményeit a tartalom visszafejtéséhez Unprotect-CmsMessage, feltéve, hogy rendelkezik a tartalom titkosításához használt dokumentumtitkosítási tanúsítvánnyal kapcsolatos információkkal.
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 titkosított tartalmat kap a C:\Users\Test\Documents\PowerShell\Future_Plans.txt.
2. példa: Titkosított tartalom átirányítása Unprotect-CmsMessage
$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 az Get-CmsMessage parancsmag eredményeit az 1. példából Unprotect-CmsMessage, az üzenet visszafejtéséhez és egyszerű szövegben való olvasásához irányítja. 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 visszafejtett üzenet: "Próbáld ki az új Összes törlése parancsot."
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: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LiteralPath
Megadja a lekérni kívánt titkosított tartalom elérési útját. A Path-tal ellentétben a LiteralPath értéke pontosan a beíráskor 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.
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: | 1 |
| 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: | 1 |
| 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 |
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.
