Get-SecretInfo

Referência

Módulo:: Microsoft.PowerShell.SecretManagement

Localiza e retorna informações de metadados sobre segredos em cofres registrados.

Sintaxe

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

Description

Esse cmdlet localiza e retorna informações sobre segredos em cofres registrados. Por padrão, ele retorna informações para cada segredo em todos os cofres registrados.

Exemplos

Exemplo 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

Este exemplo especifica o parâmetro Name como um caractere curinga único (*) para retornar metadados para todos os segredos armazenados. Há dois cofres registrados, LocalStore e CredMan. Há seis objetos SecretInformation retornados dos dois cofres.

Os objetos de saída a cada tipo válido que um segredo pode ser:

byteArray
hashable
PSCredential
SecureString
string

Exemplo 2

Get-SecretInfo -Name SecretWithMetadata | Select-Object -ExpandProperty Metadata

Key         Value
---         -----
Environment Development
Expiration  5/1/2022 12:00:00 AM
GroupNumber 7

Este exemplo recupera o segredo SecretWithMetadata e exibe seus metadados. As entradas no hashtable mostram que todos os valores de metadados de tipo válidos podem ser:

string
datetime
int

Parâmetros

-Name

Especifica o nome de um segredo. Esse cmdlet só obtém metadados para segredos que têm o nome especificado. Insira um nome ou um padrão de nome. Caracteres curinga são permitidos.

Se o parâmetro Name não for especificado, esse cmdlet retornará os metadados de todos os segredos armazenados.

Tipo:	String
Cargo:	0
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	True

-Vault

Especifica o nome de um cofre para pesquisar metadados secretos. Não são permitidos caracteres curinga.

Se o parâmetro Vault não for especificado, esse cmdlet pesquisará metadados em todos os cofres registrados.

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

None

Saídas

Microsoft.PowerShell.SecretManagement.SecretInformation