Udostępnij przez


Get-SecretInfo

Znajduje i zwraca informacje o metadanych dotyczących wpisów tajnych w zarejestrowanych magazynach.

Składnia

Default (Domyślna)

Get-SecretInfo
    [[-Name] <String>]
    [[-Vault] <String>]
    [<CommonParameters>]

Opis

To polecenie cmdlet znajduje i zwraca informacje o wpisach tajnych w zarejestrowanych magazynach. Domyślnie zwraca informacje dla każdego wpisu tajnego we wszystkich zarejestrowanych magazynach.

Przykłady

Przykład 1

Get-SecretInfo -Name *
Name                    Type VaultName
----                    ---- ---------
Secret1               String LocalStore
Secret2            ByteArray LocalStore
Secret3         SecureString LocalStore
Secret4         PSCredential LocalStore
Secret5            Hashtable LocalStore
Secret6            ByteArray CredMan

W tym przykładzie parametr Name określa się jako pojedynczy symbol wieloznaczny (*) w celu zwrócenia metadanych dla wszystkich przechowywanych wpisów tajnych. Istnieją dwa zarejestrowane magazyny LocalStore i CredMan. Istnieje sześć obiektów SecretInformation zwróconych z dwóch magazynów.

Obiekty wyjściowe każdy prawidłowy typ wpisu tajnego może być:

  • Tablica bajtów
  • Tabela skrótów
  • PSCredential
  • SecureString
  • String

Przykład 2

Get-SecretInfo -Name SecretWithMetadata | Select-Object -ExpandProperty Metadata
Key         Value
---         -----
Environment Development
Expiration  5/1/2022 12:00:00 AM
GroupNumber 7

W tym przykładzie pobierany jest wpis tajny SecretWithMetadata i wyświetlane są jego metadane. Wpisy w tabeli skrótów pokazują, że wszystkie prawidłowe wartości metadanych typu mogą być:

  • String
  • Data i czas
  • int

Parametry

-Name

Określa nazwę wpisu tajnego. To polecenie cmdlet pobiera metadane tylko dla wpisów tajnych o określonej nazwie. Wprowadź wzorzec nazwy lub nazwy. Symbole wieloznaczne są dozwolone.

Jeśli parametr Name nie zostanie określony, to polecenie cmdlet zwraca metadane dla wszystkich przechowywanych wpisów tajnych.

Właściwości parametru

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

Zestawy parametrów

(All)
Position:0
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

-Vault

Określa nazwę repozytorium do wyszukania metadanych wpisu tajnego. Symbole wieloznaczne nie są dozwolone.

Jeśli parametr Vault nie zostanie określony, to polecenie cmdlet wyszukuje metadane we wszystkich zarejestrowanych magazynach.

Właściwości parametru

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

Zestawy parametrów

(All)
Position:1
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

None

Dane wyjściowe

Microsoft.PowerShell.SecretManagement.SecretInformation