Get-SecretInfo

Referência

Módulo:: Microsoft.PowerShell.SecretManagement

Localiza e devolve informações de metadados sobre segredos em cofres registados.

Syntax

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

Description

Este cmdlet localiza e devolve informações sobre segredos em cofres registados. Por predefinição, devolve informações para cada segredo em todos os cofres registados.

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 caráter universal (*) para devolver metadados para todos os segredos armazenados. Existem dois cofres registados, LocalStore e CredMan. Existem seis objetos SecretInformation devolvidos dos dois cofres.

Os objetos de saída de todos os tipos válidos de um segredo podem 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 obtém o SecretWithMetadata segredo e apresenta os respetivos metadados. As entradas na tabela hash 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. Este cmdlet só obtém metadados para segredos que tenham o nome especificado. Introduza um padrão de nome ou nome. Os carateres universais são permitidos.

Se o parâmetro Nome não for especificado, este cmdlet devolve 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 procurar metadados secretos. Os carateres universais não são permitidos.

Se o parâmetro Vault não for especificado, este cmdlet procura metadados em todos os cofres registados.

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

Partilhar via