Set-SecretStoreConfiguration
Konfiguruje SecretStore.
Składnia
Set-SecretStoreConfiguration
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-Password <SecureString>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SecretStoreConfiguration
[-Default]
[-Password <SecureString>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
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
.
Ostrożność
Ustawienie Authentication na wartość None
jest mniej bezpieczne niż Password
. Określenie None
może być przydatne w przypadku scenariuszy testowania, ale nie powinno być używane z ważnymi wpisami tajnymi.
Typ: | Authenticate |
Position: | Named |
Domyślna wartość: | Password |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Default
Wskazuje, że SecretStore powinna być ustawiona na jego domyślną konfigurację.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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ść jest 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.
Typ: | Interaction |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PassThru
Wskazuje, że polecenie cmdlet powinno zwrócić konfigurację SecretStore po zaktualizowaniu. Domyślnie polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | SecureString |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Scope
Określa kontekst, dla którego skonfigurowano SecretStore. Obecnie obsługiwane są tylko CurrentUser
.
Typ: | SecureStoreScope |
Dopuszczalne wartości: | CurrentUser, AllUsers |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
None
Dane wyjściowe
Microsoft.PowerShell.SecretStore.SecureStoreConfig