Compartilhar via


Get-SecretInfo

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

Sintaxe

Default (Padrão)

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
  • Data e hora
  • 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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

Microsoft.PowerShell.SecretManagement.SecretInformation