Reset-SecretStore

參考

模組:: Microsoft.PowerShell.SecretStore

刪除所有秘密數據，並使用預設選項設定存放區，以重設 SecretStore。

語法

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 對於測試案例可能很有用，但不應該與重要秘密搭配使用。

類型:	Authenticate
接受的值:	None, Password
Position:	Named
預設值:	Password
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

指出 Cmdlet 應該重設 SecretStore 而不提示。根據預設，Cmdlet 會警告重設 SecretStore 的影響，並提示用戶確認。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Interaction

指定 SecretStore 是否應該在使用者存取時提示使用者。如果值是 Prompt，則使用者會在需要時在互動式會話中提示輸入其密碼。如果值 None，則不會提示使用者輸入密碼。如果值是 None 且需要密碼，則要求密碼的 Cmdlet 會擲回 Microsoft.PowerShell.SecretStore.PasswordRequiredException 錯誤。

類型:	Interaction
接受的值:	None, Prompt
Position:	Named
預設值:	Prompt
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

指出 Cmdlet 在重設它之後，應該傳回 SecretStore 組態。根據預設，Cmdlet 不會傳回任何輸出。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Password

指定 SecretStore 需要存取的密碼。如果驗證指定為 None，Cmdlet 會傳回錯誤。如果驗證Password 且未指定此參數，Cmdlet 會提示使用者安全地輸入密碼。

類型:	SecureString
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PasswordTimeout

指定使用密碼進行驗證之後，SecretStore 保持解除鎖定的時間長度。達到逾時值時，會話目前的密碼值會失效。在逾時之後存取 SecretStore 需要再次密碼。

類型:	Int32
Position:	Named
預設值:	900
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Scope

指定 SecretStore 設定的內容。目前僅支援 CurrentUser。

類型:	SecureStoreScope
接受的值:	CurrentUser, AllUsers
Position:	Named
預設值:	CurrentUser
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

Microsoft.PowerShell.SecretStore.SecureStoreConfig

共用方式為