Megosztás a következőn keresztül:

ConvertFrom-SecureString

  • Referencia
Modul:
Microsoft.PowerShell.Security

Egy biztonságos sztringet titkosított standard sztringgé alakít át.

Syntax

ConvertFrom-SecureString
                [-SecureString] <SecureString>
                [[-SecureKey] <SecureString>]
                [<CommonParameters>]
ConvertFrom-SecureString
                [-SecureString] <SecureString>
                [-AsPlainText]
                [<CommonParameters>]
ConvertFrom-SecureString
                [-SecureString] <SecureString>
                [-Key <Byte[]>]
                [<CommonParameters>]

Description

A ConvertFrom-SecureString parancsmag egy biztonságos sztringet (System.Security.SecureString) titkosított standard sztringgé (System.String) alakít át. A biztonságos sztringekkel ellentétben egy titkosított szabványos sztring menthető egy fájlba későbbi használatra. A titkosított standard sztring a parancsmaggal visszakonfigurálható a ConvertTo-SecureString biztonságos sztring formátumára.

Ha a kulcs vagy a SecureKey paraméterekkel van megadva titkosítási kulcs, a rendszer az Advanced Encryption Standard (AES) titkosítási algoritmust használja. A megadott kulcsnak 128, 192 vagy 256 bit hosszúságúnak kell lennie, mivel ezek az AES titkosítási algoritmus által támogatott kulcshosszok. Ha nincs megadva kulcs, a Windows Data Protection API (DPAPI) a szabványos sztring-ábrázolás titkosítására szolgál.

Feljegyzés

Vegye figyelembe, hogy DotNetenként a SecureString tartalma nem titkosítva van a nem Windows rendszerű rendszereken.

Példák

1. példa: Biztonságos sztring létrehozása

$SecureString = Read-Host -AsSecureString

Ez a parancs létrehoz egy biztonságos sztringet a parancssorba beírt karakterekből. A parancs megadása után írja be a biztonságos sztringként tárolni kívánt sztringet. Csillag (*) jelenik meg, amely az egyes beírt karaktereket jelöli.

2. példa: Biztonságos sztring konvertálása titkosított standard sztringgé

$StandardString = ConvertFrom-SecureString $SecureString

Ez a parancs titkosított szabványos sztringgé alakítja a $SecureString változóban lévő biztonságos sztringet. Az eredményül kapott titkosított standard sztringet a $StandardString változó tárolja.

3. példa: Biztonságos sztring átalakítása titkosított standard sztringgé 192 bites kulccsal

$Key = (3,4,2,3,56,34,254,222,1,1,2,23,42,54,33,233,1,34,2,7,6,5,35,43)
$StandardString = ConvertFrom-SecureString $SecureString -Key $Key

Ezek a parancsok az Advanced Encryption Standard (AES) algoritmussal konvertálják a $SecureString változóban tárolt biztonságos sztringet egy 192 bites kulccsal rendelkező titkosított standard sztringgé. Az eredményül kapott titkosított standard sztringet a $StandardString változó tárolja.

Az első parancs egy kulcsot tárol a $Key változóban. A kulcs egy 24 tizedesjegyből álló tömb, amelynek 256-nál kisebbnek kell lennie ahhoz, hogy egyetlen előjel nélküli bájtban elférjen.

Mivel minden tizedesjegy egyetlen bájtot (8 bitet) jelöl, a kulcs 24 számjegyből áll, összesen 192 bithez (8 x 24). Ez az AES-algoritmus érvényes kulcshossza.

A második parancs a változó kulcsával $Key konvertálja a biztonságos sztringet titkosított standard sztringgé.

4. példa: Biztonságos sztring átalakítása közvetlenül egyszerű szöveges sztringgé

$secureString = ConvertTo-SecureString -String 'Example' -AsPlainText
$secureString # 'System.Security.SecureString'
ConvertFrom-SecureString -SecureString $secureString -AsPlainText # 'Example'

Paraméterek

-AsPlainText

Ha be van állítva, ConvertFrom-SecureString a biztonságos sztringeket kimenetként a visszafejtett egyszerű szöveges sztringre konvertálja.

Ez a paraméter a PowerShell 7.0-ban lett hozzáadva.

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

-Key

A titkosítási kulcsot bájttömbként adja meg.

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecureKey

Biztonságos sztringként adja meg a titkosítási kulcsot. A biztonságos sztring értékét a rendszer bájttömbté alakítja, mielőtt kulcsként használná.

Type:SecureString
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecureString

Megadja azt a biztonságos sztringet, amely titkosított standard sztringgé konvertálható.

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

Bevitelek

SecureString

Erre a parancsmagra egy SecureString objektumot is be lehet csövezni.

Kimenetek

String

Ez a parancsmag a létrehozott egyszerű szöveges sztringet adja vissza.

Jegyzetek

  • Ha biztonságos sztringet szeretne létrehozni a parancssorban beírt karakterekből, használja a Read-Host parancsmag AsSecureString paraméterét.
  • Ha kulcs megadásához a Kulcs vagy a SecureKey paramétereket használja, a kulcs hosszának helyesnek kell lennie. Egy 128 bites kulcs például 16 decimális számból álló bájttömbként adható meg. Hasonlóképpen, a 192 bites és a 256 bites kulcsok 24, illetve 32 tizedesjegyből álló bájttömböknek felelnek meg.
  • Egyes karakterek, például hangulatjelek, több kódpontnak felelnek meg az őket tartalmazó sztringben. Kerülje ezeket a karaktereket, mert problémákat és félreértéseket okozhatnak jelszó használata esetén.