Reset-SecretStore
Reimposta SecretStore eliminando tutti i dati segreti e configurando l'archivio con le opzioni predefinite.
Sintassi
Default (Impostazione predefinita)
Reset-SecretStore
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-Password <SecureString>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Important
Il team PowerShell ha deciso che i moduli Secret sono completi in funzionalità e non saranno più sviluppati attivamente. I moduli continueranno a essere supportati per la sicurezza e la correzione di bug critici. Il repository di codice verrà archiviato.
Le ultime versioni pubblicate sono:
La natura dei segreti è cambiata radicalmente da quando è stato progettato questo progetto. Metodi di autenticazione senza password come passkey, single sign-on e sistemi di credenziali federati come Microsoft Entra ID, biometria e chiavi di sicurezza hardware sono il futuro.
Questo cmdlet reimposta completamente l' SecretStore eliminando tutti i dati segreti che può contenere e reimpostando le opzioni di configurazione sui valori predefiniti. È destinato a essere utilizzato solo in caso di smarrimento di una password richiesta o di danneggiamento dei file di dati in modo che SecretStore non funzioni più e non sia possibile accedere ai dati segreti.
È possibile eseguire l'override delle opzioni di configurazione predefinite specificando singoli parametri di opzione di configurazione dei comandi.
Esempio
Esempio 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 questo esempio viene reimpostata la SecretStore per l'utente corrente. Il cmdlet avvisa le conseguenze di questa azione e richiede conferma all'utente prima di continuare. Dopo la conferma, il cmdlet elimina tutti i segreti e imposta ogni impostazione di configurazione sul valore predefinito.
Parametri
-Authentication
Specifica come autenticare l'accesso all'SecretStore. Il valore deve essere Password o None.
Se specificato come None, il cmdlet consente l'accesso al SecretStore senza password. L'autenticazione predefinita è Password.
Attenzione
L'impostazione del di autenticazione di su None è meno sicura di Password. La specifica None può essere utile per gli scenari di test, ma non deve essere usata con segreti importanti.
Proprietà dei parametri
| Tipo: | Microsoft.PowerShell.SecretStore.Authenticate |
| Valore predefinito: | Password |
| Valori accettati: | None, Password |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Indica che il cmdlet deve reimpostare il SecretStore senza chiedere conferma. Per impostazione predefinita, il cmdlet avvisa l'impatto della reimpostazione del SecretStore e richiede conferma all'utente.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Interaction
Specifica se l' SecretStore deve richiedere a un utente di accedervi. Se il valore è Prompt, all'utente viene richiesta la password nelle sessioni interattive quando necessario. Se il valore è None, all'utente non viene richiesta una password. Se il valore è None e è necessaria una password, il cmdlet che richiede la password genera un errore Microsoft.PowerShell.SecretStore.PasswordRequiredException.
Proprietà dei parametri
| Tipo: | Microsoft.PowerShell.SecretStore.Interaction |
| Valore predefinito: | Prompt |
| Valori accettati: | None, Prompt |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PassThru
Indica che il cmdlet deve restituire la configurazione SecretStore dopo la reimpostazione. Per impostazione predefinita, il cmdlet non restituisce alcun output.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Password
Specifica la password necessaria per l'accesso al SecretStore. Se di autenticazione viene specificato come None, il cmdlet restituisce un errore. Se Authentication è e Password questo parametro non è specificato, il cmdlet richiede all'utente di immettere la password in modo sicuro.
Proprietà dei parametri
| Tipo: | SecureString |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PasswordTimeout
Specifica per quanto tempo il SecretStore rimane sbloccato dopo l'autenticazione con una password. Quando viene raggiunto il valore di timeout, il valore della password corrente viene invalidato per la sessione. L'accesso al SecretStore dopo il timeout richiede di nuovo la password.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 900 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Scope
Specifica il contesto per cui è configurato il SecretStore. Attualmente è supportato solo CurrentUser.
Proprietà dei parametri
| Tipo: | Microsoft.PowerShell.SecretStore.SecureStoreScope |
| Valore predefinito: | CurrentUser |
| Valori accettati: | CurrentUser, AllUsers |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.