Set-SecretStoreConfiguration
Configura l'SecretStore.
Sintassi
ParameterSet (Impostazione predefinita)
Set-SecretStoreConfiguration
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-Password <SecureString>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DefaultParameterSet
Set-SecretStoreConfiguration
[-Default]
[-Password <SecureString>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Importante
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 configura l' SecretStore per l'utente corrente.
Esempio
Esempio 1
PS C:\> Set-SecretStoreConfiguration -Default
Confirm
Are you sure you want to perform this action?
Performing the operation "Changes local store configuration" on target "SecretStore module local store".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Scope Authentication PasswordTimeout Interaction
----- -------------- --------------- -----------
CurrentUser Password 900 Prompt
In questo esempio viene ripristinato il SecretStore alla configurazione predefinita.
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 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ParameterSet
| 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 |
-Default
Indica che la SecretStore deve essere impostata sulla configurazione predefinita.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
DefaultParameterSet
| 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: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ParameterSet
| 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 l'aggiornamento. 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 accedere al SecretStore. Questo parametro non può essere utilizzato per modificare la password esistente. Per modificare la password esistente, usare Set-SecretStorePassword.
Quando questo parametro viene usato con il parametro authenticate per modificare la configurazione per l'autenticazione da None a Password, il valore di questo parametro viene impostato come nuova password per l'SecretStore.
Quando questo parametro viene usato con il parametro Authenticate per modificare la configurazione per l'autenticazione da Password a None, il valore di questo parametro deve essere la password corrente per il SecretStore. Viene utilizzato per autorizzare la modifica della configurazione.
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 il numero di secondi in cui il SecretStore rimane sbloccato dopo l'autenticazione con una password. Al termine del 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: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ParameterSet
| 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: | None |
| Valori accettati: | CurrentUser, AllUsers |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ParameterSet
| 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.
