Get-SecretInfo
查找并返回有关已注册保管库中机密的元数据信息。
语法
Default (默认值)
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 参数指定为单个通配符(*)字符,以返回所有存储机密的元数据。 有两个已注册的保管库,LocalStore 和 CredMan。 有六个 SecretInformation 对象从两个保管库返回。
机密的每个有效类型都可以输出对象:
- 字节数组
- 哈希表
- 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 机密并显示其元数据。 哈希表中的条目显示每个有效的类型元数据值可以是:
- 字符串
- 日期时间
- Int
参数
-Name
指定机密的名称。 此 cmdlet 仅获取具有指定名称的机密的元数据。 输入名称或名称模式。 允许使用通配符。
如果未指定 Name 参数,则此 cmdlet 将返回所有存储机密的元数据。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Vault
指定要搜索机密元数据的保管库的名称。 不允许使用通配符。
如果未指定 Vault 参数,则此 cmdlet 将在所有已注册的保管库中搜索元数据。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。