Reset-SecretStore
Återställer SecretStore genom att ta bort alla hemliga data och konfigurera arkivet med standardalternativ.
Syntax
Default (Standard)
Reset-SecretStore
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-Password <SecureString>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Important
PowerShell-teamet har beslutat att Secret-moduler är funktionskompletta och inte längre kommer att utvecklas aktivt. Modulerna kommer fortsatt att stödjas för säkerhet och kritiska buggfixar. Kodarkivet har arkiverats.
De senaste publicerade versionerna är:
Hemligheternas natur har förändrats fundamentalt sedan detta projekt designades. Lösenordslösa autentiseringsmetoder som lösennycklar, single sign-on och federerade autentiseringssystem som Microsoft Entra ID, biometrik och hårdvarusäkerhetsnycklar är framtiden.
Den här cmdleten återställer helt SecretStore- genom att ta bort alla hemliga data som den kan innehålla och återställa konfigurationsalternativen till deras standardvärden. Den är endast avsedd att användas om ett obligatoriskt lösenord går förlorat eller om datafiler skadas så att SecretStore inte längre fungerar och hemliga data inte kan nås.
Standardkonfigurationsalternativen kan åsidosättas genom att ange enskilda kommandokonfigurationsalternativparametrar.
Exempel
Exempel 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
I det här exemplet återställs SecretStore- för den aktuella användaren. Cmdleten varnar för konsekvenserna av den här åtgärden och uppmanar användaren att bekräfta innan den fortsätter. Efter bekräftelsen tar cmdleten bort alla hemligheter och anger varje konfigurationsinställning till standardvärdet.
Parametrar
-Authentication
Anger hur du autentiserar åtkomsten till SecretStore-. Värdet måste vara Password eller None.
Om cmdleten anges som Noneger den åtkomst till SecretStore- utan lösenord. Standardautentiseringen är Password.
Försiktighet
Det är mindre säkert att ange autentisering till None än Password. Att ange None kan vara användbart för att testa scenarier men bör inte användas med viktiga hemligheter.
Parameteregenskaper
| Typ: | Microsoft.PowerShell.SecretStore.Authenticate |
| Standardvärde: | Password |
| Godkända värden: | None, Password |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Force
Anger att cmdleten ska återställa SecretStore- utan att fråga. Som standard varnar cmdleten om effekten av att återställa SecretStore- och uppmanar användaren att bekräfta.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Interaction
Anger om SecretStore- ska fråga en användare när de kommer åt den. Om värdet är Promptuppmanas användaren att ange sitt lösenord i interaktiva sessioner vid behov. Om värdet är Noneuppmanas användaren inte att ange ett lösenord. Om värdet är None och ett lösenord krävs, genererar cmdleten som kräver lösenordet ett Microsoft.PowerShell.SecretStore.PasswordRequiredException fel.
Parameteregenskaper
| Typ: | Microsoft.PowerShell.SecretStore.Interaction |
| Standardvärde: | Prompt |
| Godkända värden: | None, Prompt |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-PassThru
Anger att cmdleten ska returnera konfigurationen SecretStore när den har återställts. Som standard returnerar cmdleten inga utdata.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Password
Anger lösenordet som SecretStore- ska kräva för åtkomst. Om autentisering anges som Nonereturnerar cmdleten ett fel. Om autentisering är Password och den här parametern inte anges uppmanar cmdleten användaren att ange lösenordet på ett säkert sätt.
Parameteregenskaper
| Typ: | SecureString |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-PasswordTimeout
Anger hur länge SecretStore- förblir olåst efter autentisering med ett lösenord. När tidsgränsvärdet nås ogiltigförklaras det aktuella lösenordsvärdet för sessionen. Åtkomst till SecretStore- efter tidsgränsen kräver lösenordet igen.
Parameteregenskaper
| Typ: | Int32 |
| Standardvärde: | 900 |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Scope
Anger den kontext som SecretStore- har konfigurerats för. Endast CurrentUser stöds för närvarande.
Parameteregenskaper
| Typ: | Microsoft.PowerShell.SecretStore.SecureStoreScope |
| Standardvärde: | CurrentUser |
| Godkända värden: | CurrentUser, AllUsers |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
