Set-SecretStorePassword
Zastępuje bieżące hasło SecretStore nowym.
Składnia
NoParameterSet (domyślnie)
Set-SecretStorePassword
[<CommonParameters>]
ParameterSet
Set-SecretStorePassword
-NewPassword <SecureString>
[-Password <SecureString>]
[<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 aktualizuje hasło SecretStore.
Przykłady
Przykład 1
PS C:\> Set-SecretStorePassword
Old password
Enter password:
*******
New password
Enter password:
*******
Enter password again for verification:
*******
W tym przykładzie polecenie jest uruchamiane bez argumentów parametrów. Użytkownik jest najpierw monitowany o stare hasło. Następnie dwukrotnie pojawił się monit o podanie nowego hasła w celu weryfikacji.
Przykład 2
PS C:\> Set-SecretStorePassword -NewPassword $newPassword -Password $oldPassword
W tym przykładzie uruchomiono polecenie przekazujące zarówno bieżące hasło magazynu, jak i nowe hasło do ustawienia.
Parametry
-NewPassword
Określa nowe hasło dostępu do SecretStore. Jeśli ten parametr nie zostanie określony, a polecenie cmdlet zostanie uruchomione w sesji interaktywnej, wyświetli monit o podanie wartości. Jeśli ten parametr nie zostanie określony i polecenie cmdlet zostanie uruchomione w sesji nieinterakcyjnej, zwraca błąd.
Właściwości parametru
| Typ: | SecureString |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ParameterSet
| Position: | Named |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Password
Istniejące hasło potrzebne do odblokowania sklepu. Można to zignorować, jeśli magazyn nie używa obecnie hasła.
Określa istniejące hasło dostępu do SecretStore. Jeśli magazyn sekretów nie jest skonfigurowany do wymagania hasła, ten parametr jest ignorowany.
Jeśli magazyn sekretów jest skonfigurowany tak, aby wymagał hasła, ten parametr nie jest określony, a polecenie cmdlet jest uruchamiane w sesji interaktywnej, monituje użytkownika o podanie wartości. Jeśli magazyn sekretów jest skonfigurowany tak, aby wymagał hasła, ten parametr nie jest określony, a polecenie cmdlet jest uruchamiane w sesji nieinterakcyjnej, zwraca błąd.
Właściwości parametru
| Typ: | SecureString |
| 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 |
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.
