Reset-SecretStore
Setzt den SecretStore zurück, indem alle geheimen Daten gelöscht und der Speicher mit Standardoptionen konfiguriert wird.
Syntax
Default (Standard)
Reset-SecretStore
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-Password <SecureString>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Important
Das PowerShell-Team hat entschieden, dass Secret-Module funktionsfertig sind und nicht mehr aktiv entwickelt werden. Die Module werden weiterhin für Sicherheits- und kritische Fehlerbehebungen unterstützt. Das Code-Repository wird archiviert.
Die zuletzt veröffentlichten Versionen sind:
Die Natur der Geheimnisse hat sich seit der Planung dieses Projekts grundlegend verändert. Passwortlose Authentifizierungsmethoden wie Passkeys, Single Sign-on und föderierte Zugangsdaten wie Microsoft Entra ID, Biometrie und Hardware-Sicherheitsschlüssel sind die Zukunft.
Mit diesem Cmdlet wird die SecretStore- vollständig zurückgesetzt, indem alle darin enthaltenen geheimen Daten gelöscht und Konfigurationsoptionen auf ihre Standardwerte zurückgesetzt werden. Es ist nur vorgesehen, es zu verwenden, wenn ein erforderliches Passwort verloren geht oder Datendateien beschädigt werden, so dass SecretStore nicht mehr funktioniert und auf geheime Daten nicht zugegriffen werden kann.
Die Standardkonfigurationsoptionen können überschrieben werden, indem einzelne Befehlskonfigurationsoptionsparameter angegeben werden.
Beispiele
Beispiel 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
In diesem Beispiel wird die SecretStore- für den aktuellen Benutzer zurückgesetzt. Das Cmdlet warnt vor den Folgen dieser Aktion und fordert den Benutzer zur Bestätigung auf, bevor er fortfahren kann. Nach der Bestätigung löscht das Cmdlet alle geheimen Schlüssel und legt jede Konfigurationseinstellung auf den Standardwert fest.
Parameter
-Authentication
Gibt an, wie der Zugriff auf das SecretStore-authentifiziert wird. Der Wert muss Password oder None lauten.
Wenn es als Noneangegeben ist, ermöglicht das Cmdlet den Zugriff auf das SecretStore- ohne Kennwort. Die Standardauthentifizierung ist Password.
Vorsicht
Das Festlegen der Authentifizierungs- auf None ist weniger sicher als Password. Das Angeben None kann für Testszenarien nützlich sein, sollte aber nicht mit wichtigen Geheimnissen verwendet werden.
Parametereigenschaften
| Typ: | Microsoft.PowerShell.SecretStore.Authenticate |
| Standardwert: | Password |
| Zulässige Werte: | None, Password |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Gibt an, dass das Cmdlet den SecretStore- ohne Aufforderung zurücksetzen soll. Standardmäßig warnt das Cmdlet über die Auswirkungen des Zurücksetzens des SecretStore- und fordert den Benutzer zur Bestätigung auf.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Interaction
Gibt an, ob der SecretStore- einen Benutzer auffordern soll, wenn er darauf zugreift. Wenn der Wert Promptist, wird der Benutzer bei Bedarf zur Eingabe seines Kennworts in interaktiven Sitzungen aufgefordert. Wenn der Wert ist None, wird der Benutzer nicht zur Eingabe eines Kennworts aufgefordert. Wenn der Wert None ist und ein Kennwort erforderlich ist, löst das Cmdlet, das das Kennwort erfordert, einen Microsoft.PowerShell.SecretStore.PasswordRequiredException Fehler aus.
Parametereigenschaften
| Typ: | Microsoft.PowerShell.SecretStore.Interaction |
| Standardwert: | Prompt |
| Zulässige Werte: | None, Prompt |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PassThru
Gibt an, dass das Cmdlet nach dem Zurücksetzen die SecretStore--Konfiguration zurückgeben soll. Standardmäßig gibt das Cmdlet keine Ausgabe zurück.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Password
Gibt das Kennwort an, das der SecretStore- für den Zugriff erforderlich sein soll. Wenn Authentifizierungs- als Noneangegeben ist, gibt das Cmdlet einen Fehler zurück. Wenn Authentifizierung festgelegt ist Password und dieser Parameter nicht angegeben ist, fordert das Cmdlet den Benutzer auf, das Kennwort sicher einzugeben.
Parametereigenschaften
| Typ: | SecureString |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PasswordTimeout
Gibt an, wie lange der SecretStore nach der Authentifizierung mit einem Kennwort entsperrt bleibt. Wenn der Timeoutwert erreicht ist, wird der aktuelle Kennwortwert für die Sitzung ungültig. Der Zugriff auf den SecretStore- nach dem Timeout erfordert erneut das Kennwort.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | 900 |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Scope
Gibt den Kontext an, für den der SecretStore- konfiguriert ist. Derzeit wird nur CurrentUser unterstützt.
Parametereigenschaften
| Typ: | Microsoft.PowerShell.SecretStore.SecureStoreScope |
| Standardwert: | CurrentUser |
| Zulässige Werte: | CurrentUser, AllUsers |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
