Get-SecretInfo

Busca y devuelve información de metadatos sobre los secretos en almacenes registrados.

Sintaxis

Default (valor predeterminado)

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

Description

Important

El equipo de PowerShell ha decidido que los módulos Secret son completos en funciones y que ya no se desarrollarán activamente. Los módulos seguirán siendo compatibles con la seguridad y la corrección de errores críticos. El repositorio de código ha sido archivado.

Las últimas versiones publicadas son:

La naturaleza de los secretos ha cambiado fundamentalmente desde que se diseñó este proyecto. Los métodos de autenticación sin contraseña como las llaves de acceso, el inicio de sesión único y los sistemas federados de credenciales como Microsoft Entra ID, biometría y claves de seguridad hardware son el futuro.

Este cmdlet busca y devuelve información sobre los secretos en almacenes registrados. De forma predeterminada, devuelve información de todos los secretos de todos los almacenes registrados.

Ejemplos

Ejemplo 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

En este ejemplo se especifica el parámetro Name como un solo carácter comodín (*) para devolver metadatos para todos los secretos almacenados. Hay dos almacenes registrados, LocalStore y CredMan. Hay seis objetos SecretInformation devueltos desde los dos almacenes.

Los objetos de salida cada tipo válido que un secreto puede ser:

  • byteArray
  • hashtable
  • PSCredential
  • SecureString
  • cadena

Ejemplo 2

Get-SecretInfo -Name SecretWithMetadata | Select-Object -ExpandProperty Metadata
Key         Value
---         -----
Environment Development
Expiration  5/1/2022 12:00:00 AM
GroupNumber 7

En este ejemplo se recupera el secreto de SecretWithMetadata y se muestran sus metadatos. Las entradas de la tabla hash muestran todos los valores de metadatos de tipo válidos pueden ser:

  • cadena
  • DateTime
  • int

Parámetros

-Name

Especifica el nombre de un secreto. Este cmdlet solo obtiene los metadatos de los secretos que tienen el nombre especificado. Escriba un nombre o patrón de nombre. Se permiten caracteres comodín.

Si no se especifica el parámetro Name , este cmdlet devuelve los metadatos de todos los secretos almacenados.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Vault

Especifica el nombre de un almacén para buscar metadatos secretos. No se admite el uso de caracteres comodín.

Si no se especifica el parámetro Vault , este cmdlet busca metadatos en todos los almacenes registrados.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

Microsoft.PowerShell.SecretManagement.SecretInformation