Partilhar via


Get-SecretInfo

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

Sintaxe

Default (Predefinição)

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

Description

Este 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. Existem dois cofres registados, LocalStore e CredMan. Há seis objetos SecretInformation retornados dos dois cofres.

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

  • ByteArray
  • Hashtable
  • 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 na tabela de hash mostram todos os valores de metadados de tipo válidos podem ser:

  • String
  • Data/Hora
  • Int

Parâmetros

-Name

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

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Vault

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

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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