Get-SecretInfo

查找并返回有关已注册保管库中机密的元数据信息。

语法

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

说明

此 cmdlet 查找并返回有关已注册保管库中机密的信息。 默认情况下,它将返回所有已注册保管库中每个机密的信息。

示例

示例 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

此示例将 Name 参数指定为单个通配符(*)字符,以返回所有存储机密的元数据。 有两个已注册的保管库,LocalStoreCredMan。 有六个 SecretInformation 对象从两个保管库返回。

机密的每个有效类型都可以输出对象:

  • ByteArray
  • 哈希表
  • PSCredential
  • SecureString
  • 字符串

示例 2

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

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

此示例检索 SecretWithMetadata 机密并显示其元数据。 哈希表中的条目显示每个有效的类型元数据值可以是:

  • 字符串
  • DateTime
  • Int

参数

-Name

指定机密的名称。 此 cmdlet 仅获取具有指定名称的机密的元数据。 输入名称或名称模式。 允许使用通配符。

如果未指定 Name 参数,则此 cmdlet 将返回所有存储机密的元数据。

类型:String
Position:0
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-Vault

指定要搜索机密元数据的保管库的名称。 不允许使用通配符。

如果未指定 Vault 参数,则此 cmdlet 将在所有已注册的保管库中搜索元数据。

类型:String
Position:1
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

Microsoft.PowerShell.SecretManagement.SecretInformation