ConvertFrom-SecureString

發行項
10/30/2009

將安全性字串轉換成標準加密字串。

語法

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

ConvertFrom-SecureString [[-SecureKey] <SecureString>] [-SecureString] <SecureString> [<CommonParameters>]

描述

ConvertFrom-SecureString Cmdlet 會將安全字串 (System.Security.SecureString) 轉換成標準加密字串 (System.String)。與安全字串不同，標準加密字串可以儲存在檔案中，以便日後使用。您可以使用 ConvertTo-SecureString Cmdlet，將標準加密字串轉換回安全字串格式。如果使用 Key 或 SecureKey 參數指定加密金鑰，則會採用 Rijndael 加密演算法。指定金鑰的長度必須是 128、192 或 256 位元，因為這些是 Rijndael 加密演算法所支援的金鑰長度。如果沒有指定金鑰，則會使用 Windows 資料保護 API (DPAPI) 來加密標準字串表示。

參數

-Key <Byte[]>

指定加密金鑰做為位元組陣列。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-SecureKey <SecureString>

指定加密金鑰做為安全性字串。安全性字串值會先轉換成位元組陣列再當作金鑰使用。

必要?	false
位置?	2
預設值
接受管線輸入?	false
接受萬用字元?	false

-SecureString <SecureString>

指定要轉換成標準加密字串的安全性字串。

必要?	true
位置?	1
預設值
接受管線輸入?	true (ByValue)
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Security.SecureString

您可經由管道將 SecureString 物件輸出至 ConvertFrom-SecureString。

輸出

System.String

ConvertFrom-SecureString 會傳回標準字串物件。

附註

若要根據命令提示字元中輸入的字元建立安全字串，請使用 Read-Host Cmdlet 的 AsSecureString 參數。

當您使用 Key 或 SecureKey 參數指定金鑰時，金鑰長度必須是正確的。例如，可以將 128 位元的金鑰指定為 16 位數的位元組陣列。同樣地，192 位元和 256 位元金鑰會分別對應至 24 和 32 位數的位元組陣列。

範例 1

C:\PS>$securestring = read-host -assecurestring

描述
-----------
這個命令會根據您在命令提示字元中輸入的字元建立安全字串。輸入命令之後，請輸入您要儲存為安全性字串的字串。此時會顯示星號 (*) 來代表您輸入的每個字元。

範例 2

C:\PS>$standardstring = convertfrom-securestring  $securestring

描述
-----------
這個命令會將 $securestring 變數中的安全字串轉換成標準加密字串。產生的標準加密字串會儲存在 $standardstring 變數中。

範例 3

C:\PS>$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)

C:\PS> $standardstring = convertfrom-securestring  $securestring -key $key

描述
-----------
這些命令會使用 Rijndael 演算法，將 $securestring 變數中儲存的安全字串轉換成具有 192 位元金鑰的標準加密字串。產生的標準加密字串會儲存在 $standardstring 變數中。

第一個命令會將金鑰儲存在 $key 變數中。該金鑰是 24 位數的陣列，其中所有位數都小於 256。
 
因為每個位數都代表一個位元組 (8 位元)，所以該金鑰的 24 位數總計為 192 位元 (8 x 24)。這是 Rijndael 演算法的有效金鑰長度。每個個別值都會小於 256，因為這是不帶正負號的位元組所能儲存的最大值。

第二個命令會使用 $key 變數中的金鑰，將安全字串轉換成標準加密字串。

請參閱

概念

ConvertTo-SecureString
Read-Host

共用方式為