Reset-SecretStore

Moduł:

Microsoft.PowerShell.SecretStore

Resetuje magazyn wpisów tajnych, usuwając wszystkie dane tajne i konfigurując magazyn z opcjami domyślnymi.

Składnia

Reset-SecretStore
     [-Scope <SecureStoreScope>]
     [-Authentication <Authenticate>]
     [-Password <SecureString>]
     [-PasswordTimeout <Int32>]
     [-Interaction <Interaction>]
     [-PassThru]
     [-Force]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Opis

To polecenie cmdlet całkowicie resetuje SecretStore przez usunięcie wszystkich danych tajnych, które mogą zawierać, i zresetowanie opcji konfiguracji do ich wartości domyślnych. Ma być używany tylko wtedy, gdy wymagane hasło zostanie utracone lub pliki danych staną się uszkodzone, aby SecretStore nie mogą już działać i nie można uzyskać dostępu do danych tajnych.

Domyślne opcje konfiguracji można zastąpić, określając poszczególne parametry opcji konfiguracji polecenia.

Przykłady

Przykład 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

W tym przykładzie SecretStore dla bieżącego użytkownika. Polecenie cmdlet ostrzega o konsekwencjach tej akcji i monituje użytkownika o potwierdzenie przed kontynuowaniem. Po potwierdzeniu polecenie cmdlet usuwa wszystkie wpisy tajne i ustawia każde ustawienie konfiguracji na wartość domyślną.

Parametry

-Authentication

Określa sposób uwierzytelniania dostępu do SecretStore. Wartość musi być Password lub None. Jeśli określono None, polecenie cmdlet umożliwia dostęp do SecretStore bez hasła. Domyślne uwierzytelnianie to Password.

Ostrożność

Ustawienie Authentication na wartość None jest mniej bezpieczne niż Password. Określenie None może być przydatne w przypadku scenariuszy testowania, ale nie powinno być używane z ważnymi wpisami tajnymi.

Typ:	Authenticate
Dopuszczalne wartości:	None, Password
Position:	Named
Domyślna wartość:	Password
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Force

Wskazuje, że polecenie cmdlet powinno zresetować SecretStore bez monitowania. Domyślnie polecenie cmdlet ostrzega o wpływie resetowania SecretStore i monituje użytkownika o potwierdzenie.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Interaction

Określa, czy SecretStore powinien monitować użytkownika podczas uzyskiwania do niego dostępu. Jeśli wartość jest Prompt, użytkownik jest monitowany o hasło w sesjach interakcyjnych, jeśli jest to wymagane. Jeśli wartość jest None, użytkownik nie jest monitowany o podanie hasła. Jeśli wartość jest None, a hasło jest wymagane, polecenie cmdlet wymagające hasła zgłasza błąd Microsoft.PowerShell.SecretStore.PasswordRequiredException.

Typ:	Interaction
Dopuszczalne wartości:	None, Prompt
Position:	Named
Domyślna wartość:	Prompt
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-PassThru

Wskazuje, że polecenie cmdlet powinno zwrócić konfigurację SecretStore po zresetowaniu. Domyślnie polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Password

Określa hasło SecretStore powinny wymagać dostępu. Jeśli uwierzytelniania zostanie określony jako None, polecenie cmdlet zwróci błąd. Jeśli uwierzytelniania jest Password i ten parametr nie zostanie określony, polecenie cmdlet monituje użytkownika o bezpieczne wprowadzenie hasła.

Typ:	SecureString
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-PasswordTimeout

Określa, jak długo SecretStore pozostaje odblokowany po uwierzytelnieniu przy użyciu hasła. Po osiągnięciu wartości limitu czasu bieżąca wartość hasła jest unieważniona dla sesji. Uzyskiwanie dostępu do SecretStore po przekroczeniu limitu czasu wymaga ponownego hasła.

Typ:	Int32
Position:	Named
Domyślna wartość:	900
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Scope

Określa kontekst, dla którego skonfigurowano SecretStore. Obecnie obsługiwane są tylko CurrentUser.

Typ:	SecureStoreScope
Dopuszczalne wartości:	CurrentUser, AllUsers
Position:	Named
Domyślna wartość:	CurrentUser
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

None

Dane wyjściowe

Microsoft.PowerShell.SecretStore.SecureStoreConfig