Reset-SecretStore
藉由刪除所有秘密資料,並使用預設選項設定存放區來重設 SecretStore。
Syntax
Reset-SecretStore
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-Password <SecureString>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此 Cmdlet 會刪除其可能包含的所有秘密資料,並將組態選項重設為預設值,以完全重設 SecretStore 。 只有在遺失必要的密碼或資料檔案損毀時,才會使用它,以便 SecretStore 不再運作,而且無法存取秘密資料。
您可以藉由指定個別命令組態選項參數來覆寫預設組態選項。
範例
範例 1
PS C:\> Reset-SecretStore -PassThru
WARNING: !!This operation will completely remove all SecretStore module secrets and reset
configuration settings to default values!!
Reset SecretStore
Are you sure you want to erase all secrets in SecretStore and reset configuration settings to default?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): Y
Creating a new Microsoft.PowerShell.SecretStore vault. A password is required by the current store configuration.
Enter password:
********
Enter password again for verification:
********
Scope Authentication PasswordTimeout Interaction
----- -------------- --------------- -----------
CurrentUser Password 900 Prompt
本範例會重設目前使用者的 SecretStore 。 Cmdlet 會警告此動作的結果,並提示使用者確認再繼續。 確認之後,Cmdlet 會刪除所有秘密,並將每個組態設定設為預設值。
參數
-Authentication
指定如何驗證 SecretStore的存取權。 其值必須為 Password
或 None
。
如果指定為 None
,Cmdlet 會啟用不具密碼的 SecretStore 存取權。 預設驗證為 Password
。
警告
將 驗證 設定為 None
比 不安全 Password
。 指定 None
可能會對測試案例很有用,但不應該與重要秘密搭配使用。
Type: | Authenticate |
Accepted values: | None, Password |
Position: | Named |
Default value: | Password |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
指出 Cmdlet 應該重設 SecretStore 而不提示。 根據預設,Cmdlet 會警告重設 SecretStore 的影響,並提示使用者確認。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Interaction
指定 SecretStore 是否應該在使用者存取時提示使用者。 如果值為 Prompt
,使用者會在需要時于互動式會話中提示輸入其密碼。 如果值為 None
,則不會提示使用者輸入密碼。 如果值為 None
且需要密碼,則要求密碼的 Cmdlet 會擲回 Microsoft.PowerShell.SecretStore.PasswordRequiredException 錯誤。
Type: | Interaction |
Accepted values: | None, Prompt |
Position: | Named |
Default value: | Prompt |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
指出 Cmdlet 應該在重設 SecretStore 組態之後傳回它。 根據預設,Cmdlet 不會傳回任何輸出。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
指定 SecretStore 需要存取的密碼。 如果 驗證 指定為 None
,Cmdlet 會傳回錯誤。 如果未指定 Authentication , Password
而且未指定此參數,Cmdlet 會提示使用者安全地輸入密碼。
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordTimeout
指定使用密碼進行驗證之後 ,SecretStore 保持解除鎖定的時間長度。 達到逾時值時,會話目前的密碼值會失效。 逾時之後存取 SecretStore 需要再次密碼。
Type: | Int32 |
Position: | Named |
Default value: | 900 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
指定 SecretStore 設定的內容。 目前僅 CurrentUser
支援 。
Type: | SecureStoreScope |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | CurrentUser |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
None
輸出
Microsoft.PowerShell.SecretStore.SecureStoreConfig