Udostępnij przez


Unregister-SecretVault

Wyrejestruje magazyn rozszerzeń z funkcji SecretManagement dla bieżącego użytkownika.

Składnia

NameParameterSet

Unregister-SecretVault
    [-Name] <String[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SecretVaultParameterSet

Unregister-SecretVault
    [-SecretVault] <SecretVaultInfo>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

To polecenie cmdlet wyrejestruje określony magazyn rozszerzeń. Po wyrejestrowanym magazynie nie będzie już dostępny SecretManagement dla bieżącego użytkownika.

Przykłady

Przykład 1

PS C:\> Get-SecretVault

VaultName  ModuleName                        IsDefaultVault
---------  ----------                        --------------
CredMan    Microsoft.PowerShell.CredManStore False
LocalStore Microsoft.PowerShell.SecretStore  True

PS C:\> Unregister-SecretVault LocalStore
PS C:\> Get-SecretVault

VaultName ModuleName                        IsDefaultVault
--------- ----------                        --------------
CredMan   Microsoft.PowerShell.CredManStore False

PS C:\> Get-Secret -Name Secret5
Get-Secret: The secret Secret5 wasn't found.

PS C:\> Register-SecretVault -Name SecretStore -ModuleName Microsoft.PowerShell.SecretStore -DefaultVault
PS C:\> Get-SecretVault

VaultName   ModuleName                        IsDefaultVault
---------   ----------                        --------------
CredMan     Microsoft.PowerShell.CredManStore False
SecretStore Microsoft.PowerShell.SecretStore  True

PS C:\> Get-Secret -Name Secret5
System.Security.SecureString

Pierwsze polecenie wyświetla listę zarejestrowanych magazynów dla bieżącego użytkownika. Drugie polecenie wyrejestruje magazyn LocalStore. Trzecie polecenie sprawdza, czy magazyn nie jest już wyświetlany w rejestrze. Czwarte polecenie próbuje pobrać Secret5, ale nie można go znaleźć, ponieważ jego magazyn został niezarejestrowany. Piąte polecenie ponownie rejestruje magazyn pod inną nazwą i ustawia go jako magazyn domyślny użytkownika. Szóste polecenie sprawdza, czy magazyn został ponownie zarejestrowany jako SecretStore i jest magazynem domyślnym. Na koniec ostatnie polecenie pobiera Secret5 z ponownie zarejestrowanego magazynu.

Przykład 2

PS C:\> Get-SecretVault | Unregister-SecretVault
PS C:\> Get-SecretVault

W tym przykładzie wyrejestruje wszystkie magazyny rozszerzeń dla bieżącego użytkownika. Drugie polecenie pokazuje, że żadne magazyny nie są zarejestrowane.

W tym przykładzie wyrejestruje wszystkie magazyny rozszerzeń dla bieżącego użytkownika. Get-SecretVault pobiera wszystkie zarejestrowane magazyny dla bieżącego użytkownika i wysyła wynik za pośrednictwem potoku do Unregister-SecretVault. Get-SecretVault pokazuje, że wpis tajny już nie istnieje w magazynie.

Parametry

-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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa nazwę magazynu do wyrejestrowania. Wprowadź wzorzec nazwy lub nazwy. Dozwolone są symbole wieloznaczne (*).

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

NameParameterSet
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SecretVault

Określa obiekt SecretVaultInfo reprezentujący magazyn do wyrejestrowania.

Właściwości parametru

Typ:Microsoft.PowerShell.SecretManagement.SecretVaultInfo
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SecretVaultParameterSet
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
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ązkowy: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.

Dane wejściowe

Microsoft.PowerShell.SecretManagement.SecretVaultInfo

Dane wyjściowe

None