Unlock-SecretStore
Entsperrt SecretStore mit dem bereitgestellten Kennwort.
Syntax
Default (Standard)
Unlock-SecretStore
-Password <SecureString>
[-PasswordTimeout <Int32>]
[<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 wurde 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- für den aktuellen Benutzer mit dem angegebenen Kennwort entsperrt. Sie kann verwendet werden, um die SecretStore- zu entsperren, wenn die Konfiguration ein Kennwort erfordert und die Eingabeaufforderungskonfigurationsoption deaktiviert ist. Der SecretStore- bleibt in der Sitzung entsperrt, bis das konfigurierte Kennworttimeout verstrichen ist.
Beispiele
Beispiel 1
PS C:\> Get-Secret Secret1 -Vault LocalStore
Get-Secret: A valid password is required to access the Microsoft.PowerShell.SecretStore vault.
Get-Secret: The secret Secret1 wasn't found.
PS C:\> Unlock-SecretStore
cmdlet Unlock-SecretStore at command pipeline position 1
Supply values for the following parameters:
SecureStringPassword: *******
PS C:\> Get-Secret Secret1 -Vault LocalStore
System.Security.SecureString
In diesem Beispiel kann Get-Secret nicht Secret1 abrufen, da der SecretStore- Tresor gesperrt ist.
Unlock-SecretStore entsperrt den Tresor. Das Cmdlet fordert zur Eingabe des Kennworts auf, da der Parameter Password nicht angegeben wurde. Wenn der Tresor entsperrt ist, gibt Get-SecretSecret1 als SecureString--Objekt zurück.
Parameter
-Password
Gibt das Kennwort an, das für den Zugriff auf das SecretStore-erforderlich ist.
Parametereigenschaften
| Typ: | SecureString |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-PasswordTimeout
Gibt an, wie viele Sekunden das SecretStore nach der Authentifizierung mit einem Kennwort entsperrt bleibt. Dieser Parameter setzt den konfigurierten Kennworttimeoutwert außer Kraft. Nachdem das Timeout abgelaufen 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: | 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 |
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.
