Set-SecretStoreConfiguration
Konfiguruje SecretStore.
Składnia
ParameterSet (domyślnie)
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>]
Opis
Ważna
Zespół PowerShell zdecydował, że moduły Secret są funkcjonalnie kompletne i nie będą już aktywnie rozwijane. Moduły będą nadal wspierane w zakresie bezpieczeństwa i krytycznych poprawek błędów. Repozytorium kodu zostało zarchiwizowane.
Najnowsze opublikowane wersje to:
Charakter sekretów zasadniczo się zmienił od czasu powstania tego projektu. Metody uwierzytelniania bez hasła, takie jak klucze dostępowe, single log-on oraz federacyjne systemy uwierzytelniania, takie jak Microsoft Entra ID, biometria i sprzętowe klucze bezpieczeństwa, to przyszłość.
To polecenie cmdlet konfiguruje SecretStore dla bieżącego użytkownika.
Przykłady
Przykład 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
W tym przykładzie SecretStore do konfiguracji domyślnej.
Parametry
-Authentication
Określa sposób uwierzytelniania dostępu do SecretStore. Wartość musi być Password lub None.
Jeśli określono None, polecenie cmdlet umożliwia dostęp do SecretStore bez hasła. Domyślne uwierzytelnianie to Password.
Ostrzeżenie
Ustawienie Authentication na wartość None jest mniej bezpieczne niż Password. Określanie None może być przydatne w przypadku scenariuszy testowych, ale nie powinno być używane z ważnymi wpisami tajnymi.
Właściwości parametru
| Typ: | Microsoft.PowerShell.SecretStore.Authenticate |
| Domyślna wartość: | Password |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ParameterSet
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Default
Wskazuje, że SecretStore powinna być ustawiona na jego domyślną konfigurację.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
DefaultParameterSet
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Interaction
Określa, czy SecretStore powinien monitować użytkownika podczas uzyskiwania do niego dostępu. Jeśli wartość jest Prompt, użytkownik jest monitowany o hasło w sesjach interakcyjnych, jeśli jest to wymagane. Jeśli wartość to None, użytkownik nie jest monitowany o podanie hasła. Jeśli wartość jest None, a hasło jest wymagane, polecenie cmdlet wymagające hasła zgłasza błąd Microsoft.PowerShell.SecretStore.PasswordRequiredException.
Właściwości parametru
| Typ: | Microsoft.PowerShell.SecretStore.Interaction |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ParameterSet
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-PassThru
Wskazuje, że polecenie cmdlet powinno zwrócić konfigurację SecretStore po zaktualizowaniu. Domyślnie polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Password
Określa hasło wymagane do uzyskania dostępu do SecretStore. Tego parametru nie można użyć do zmiany istniejącego hasła. Aby zmienić istniejące hasło, użyj Set-SecretStorePassword.
Gdy ten parametr jest używany z parametrem Authentication w celu zmiany konfiguracji uwierzytelniania z None na Password, wartość tego parametru jest ustawiana jako nowe hasło dla SecretStore.
Jeśli ten parametr jest używany z parametrem Uwierzytelnij, aby zmienić konfigurację uwierzytelniania z Password na None, wartość tego parametru musi być bieżącym hasłem dla SecretStore. Służy do autoryzowania zmiany konfiguracji.
Właściwości parametru
| Typ: | SecureString |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-PasswordTimeout
Określa, ile sekund SecretStore pozostaje odblokowany po uwierzytelnieniu przy użyciu hasła. Po upłynięciu limitu czasu bieżąca wartość hasła jest unieważniona dla sesji. Uzyskiwanie dostępu do SecretStore po przekroczeniu limitu czasu wymaga ponownego hasła.
Właściwości parametru
| Typ: | Int32 |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ParameterSet
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Scope
Określa kontekst, dla którego skonfigurowano SecretStore. Obecnie obsługiwane są tylko CurrentUser.
Właściwości parametru
| Typ: | Microsoft.PowerShell.SecretStore.SecureStoreScope |
| Domyślna wartość: | None |
| Dopuszczalne wartości: | CurrentUser, AllUsers |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ParameterSet
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
