Reset-SecretStore
Setzt den SecretStore zurück, indem alle geheimen Daten gelöscht und der Speicher mit Standardoptionen konfiguriert wird.
Syntax
Reset-SecretStore
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-Password <SecureString>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet setzt den SecretStore vollständig zurück, indem alle möglicherweise darin enthaltenen geheimen Daten gelöscht und die Konfigurationsoptionen auf ihre Standardwerte zurückgesetzt werden. Es ist nur gedacht, wenn ein erforderliches Kennwort verloren geht oder Datendateien beschädigt werden, sodass 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 der 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 Geheimnisse und legt jede Konfigurationseinstellung auf ihren Standardwert fest.
Parameter
-Authentication
Gibt an, wie der Zugriff auf den SecretStore authentifiziert wird. Der Wert muss Password
oder None
lauten.
Wenn als angegeben None
, ermöglicht das Cmdlet den Zugriff auf den SecretStore ohne Kennwort. Die Standardauthentifizierung ist Password
.
Achtung
Das Festlegen der Authentifizierung auf None
ist weniger sicher als Password
. Die Angabe None
kann für Testszenarien nützlich sein, sollte aber nicht mit wichtigen Geheimnissen verwendet werden.
Type: | Authenticate |
Accepted values: | None, Password |
Position: | Named |
Default value: | Password |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Gibt an, dass das Cmdlet den SecretStore ohne Aufforderung zurücksetzen soll. Standardmäßig warnt das Cmdlet vor den Auswirkungen des Zurücksetzens des SecretStore und fordert den Benutzer zur Bestätigung auf.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Interaction
Gibt an, ob der SecretStore einen Benutzer auffordern soll, wenn er darauf zugreift. Wenn der Wert lautet Prompt
, wird der Benutzer bei Bedarf in interaktiven Sitzungen zur Eingabe seines Kennworts aufgefordert. Wenn der Wert lautet None
, wird der Benutzer nicht zur Eingabe eines Kennworts aufgefordert. Wenn der Wert ist None
und ein Kennwort erforderlich ist, löst das Cmdlet, das das Kennwort erfordert, einen Microsoft.PowerShell.SecretStore.PasswordRequiredException-Fehler aus.
Type: | Interaction |
Accepted values: | None, Prompt |
Position: | Named |
Default value: | Prompt |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Gibt an, dass das Cmdlet die SecretStore-Konfiguration zurückgeben soll, nachdem sie zurückgesetzt wurde. Standardmäßig gibt das Cmdlet keine Ausgabe zurück.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
Gibt das Kennwort an, das der SecretStore für den Zugriff benötigen soll. Wenn Authentifizierung als None
angegeben ist, gibt das Cmdlet einen Fehler zurück. Wenn Authentifizierung ist Password
und dieser Parameter nicht angegeben ist, fordert das Cmdlet den Benutzer auf, das Kennwort sicher einzugeben.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordTimeout
Gibt an, wie lange der SecretStore nach der Authentifizierung mit einem Kennwort entsperrt bleibt. Wenn der Timeoutwert erreicht wird, wird der aktuelle Kennwortwert für die Sitzung ungültig. Für den Zugriff auf den SecretStore nach dem Timeout ist das Kennwort erneut erforderlich.
Type: | Int32 |
Position: | Named |
Default value: | 900 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Gibt den Kontext an, für den der SecretStore konfiguriert ist. Derzeit wird nur CurrentUser
unterstützt.
Type: | SecureStoreScope |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | CurrentUser |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
None
Ausgaben
Microsoft.PowerShell.SecretStore.SecureStoreConfig