Compartilhar via


Get-SecretInfo

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

Syntax

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 único caractere curinga (*) 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 de cada tipo válido que um segredo pode ser:

  • ByteArray
  • Hashtable
  • PSCredential
  • SecureString
  • Cadeia de caracteres

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 SecretWithMetadata segredo e exibe seus metadados. As entradas na tabela de hash mostram que todos os valores de metadados de tipo válidos podem ser:

  • Cadeia de caracteres
  • 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. Digite um nome ou 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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Vault

Especifica o nome de um cofre para pesquisar metadados secretos. Caracteres curinga não são permitidos.

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

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

Microsoft.PowerShell.SecretManagement.SecretInformation