Freigeben über


Get-SecretInfo

Sucht metadateninformationen zu Geheimnissen in registrierten Tresoren und gibt diese zurück.

Syntax

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

Beschreibung

Dieses Cmdlet sucht Und gibt Informationen zu Geheimnissen in registrierten Tresoren zurück. Standardmäßig werden Informationen für jedes Geheimnis in allen registrierten Tresoren zurückgegeben.

Beispiele

Beispiel 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

In diesem Beispiel wird der Name-Parameter als einzelnes Feldzeichen (*) angegeben, um Metadaten für alle gespeicherten Geheimnisse zurückzugeben. Es gibt zwei registrierte Tresore und LocalStoreCredMan. Aus den beiden Tresoren werden sechs SecretInformation-Objekte zurückgegeben.

Die Ausgabeobjekte jeder gültige Typ eines Geheimnisses kann sein:

  • ByteArray
  • Hashtable
  • PSCredential
  • SecureString
  • String

Beispiel 2

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

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

In diesem Beispiel wird das SecretWithMetadata Geheimnis abgerufen und seine Metadaten angezeigt. Die Einträge in der Hashtabelle zeigen, dass alle gültigen Typmetadatenwerte wie folgt sein können:

  • String
  • DateTime
  • Int

Parameter

-Name

Gibt den Namen eines Geheimnisses an. Dieses Cmdlet ruft nur Metadaten für Geheimnisse ab, die den angegebenen Namen haben. Geben Sie einen Namen oder ein Namensmuster ein. Platzhalterzeichen sind zulässig.

Wenn der Name-Parameter nicht angegeben wird, gibt dieses Cmdlet die Metadaten für alle gespeicherten Geheimnisse zurück.

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

-Vault

Gibt den Namen eines Tresors an, der nach geheimen Metadaten suchen soll. Platzhalterzeichen sind nicht zulässig.

Wenn der Vault-Parameter nicht angegeben ist, sucht dieses Cmdlet nach Metadaten in allen registrierten Tresoren.

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

Eingaben

None

Ausgaben

Microsoft.PowerShell.SecretManagement.SecretInformation