Set-SecretStoreConfiguration
設定 SecretStore。
語法
ParameterSet (預設值)
Set-SecretStoreConfiguration
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-Password <SecureString>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DefaultParameterSet
Set-SecretStoreConfiguration
[-Default]
[-Password <SecureString>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Important
PowerShell 團隊決定 Secret 模組功能已完整，將不再積極開發。 這些模組將持續提供安全及關鍵錯誤修正支援。 程式碼庫已被歸檔。
最新出版版本如下：
自從這個專案設計以來，祕密的本質已經徹底改變。 無密碼認證方法如通行金鑰、單一登入，以及聯邦憑證系統如 Microsoft Entra ID、生物辨識和硬體安全金鑰，是未來趨勢。
此 Cmdlet 會設定目前使用者的 SecretStore。
範例
範例 1
PS C:\> Set-SecretStoreConfiguration -Default
Confirm
Are you sure you want to perform this action?
Performing the operation "Changes local store configuration" on target "SecretStore module local store".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Scope Authentication PasswordTimeout Interaction
----- -------------- --------------- -----------
CurrentUser Password 900 Prompt
此範例會將 SecretStore 還原為其預設組態。
參數
-Authentication
指定如何驗證對 SecretStore的存取權。 其值必須為 Password 或 None。
如果指定為 None，Cmdlet 會啟用不使用密碼存取 SecretStore。 預設驗證 Password。
謹慎
將 驗證 設定為 None 比 Password不安全。 指定 None 可能對測試方案有用，但不應與重要密鑰一起使用。
參數屬性
| 類型: | Microsoft.PowerShell.SecretStore.Authenticate |
| 預設值: | Password |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Default
表示 SecretStore 應設定為其預設組態。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
DefaultParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Interaction
指定 SecretStore 是否應該在使用者存取時提示使用者。 如果值是 Prompt，則使用者會在需要時在互動式會話中提示輸入其密碼。 如果值為 None，則不會提示使用者輸入密碼。 如果值是 None 且需要密碼，則要求密碼的 Cmdlet 會擲回 Microsoft.PowerShell.SecretStore.PasswordRequiredException 錯誤。
參數屬性
| 類型: | Microsoft.PowerShell.SecretStore.Interaction |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PassThru
指出 Cmdlet 在更新它之後，應該傳回 SecretStore 組態。 根據預設，Cmdlet 不會傳回任何輸出。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Password
指定存取 SecretStore所需的密碼。 此參數不能用於更改現有密碼。 若要變更現有的密碼，請使用 Set-SecretStorePassword。
當此參數與 Authenticate 參數搭配使用時，將驗證的組態從 None 變更為 Password，此參數的值會設定為 SecretStore的新密碼。
當此參數與 Authenticate 參數搭配使用時，將驗證的組態從 Password 變更為 None，此參數的值必須是 SecretStore目前的密碼。 它用於授權配置更改。
參數屬性
| 類型: | SecureString |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PasswordTimeout
指定使用密碼進行驗證之後，SecretStore 仍保持解除鎖定的秒數。 逾時經過之後，會話目前的密碼值就會失效。 在逾時之後存取 SecretStore 需要再次密碼。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Scope
指定 SecretStore 設定的內容。 目前僅支援 CurrentUser。
參數屬性
| 類型: | Microsoft.PowerShell.SecretStore.SecureStoreScope |
| 預設值: | None |
| 接受的值: | CurrentUser, AllUsers |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 該 Cmdlet 未被執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
