Get-Secret

Módulo:

Microsoft.PowerShell.SecretManagement

Busca y devuelve un secreto por nombre de los almacenes registrados.

Sintaxis

Get-Secret
   [-Name] <String>
   [[-Vault] <String>]
   [-AsPlainText]
   [<CommonParameters>]

Get-Secret
   [-InputObject] <SecretInformation>
   [-AsPlainText]
   [<CommonParameters>]

Description

Este cmdlet busca y devuelve el primer secreto que coincide con el nombre proporcionado. Si se especifica un nombre de almacén, solo se busca ese almacén. De lo contrario, busca en todos los almacenes y devuelve el primer resultado coincidente. Si el registro del almacén tiene un almacén predeterminado, el cmdlet busca ese almacén antes de cualquier otro almacén registrado. Los secretos que se string o los tipos de SecureString se devuelven como objetos SecureString de forma predeterminada.

Ejemplos

Ejemplo 1

Get-Secret -Name Secret1 -Vault CredMan
Get-Secret -Name Secret1 -Vault CredMan -AsPlainText

System.Security.SecureString
PlainTextSecretString

En este ejemplo se busca un secreto con el nombre Secret1, que es un secreto de tipo string de. El primer comando devuelve el secreto como un objeto SecureString. El segundo comando usa el parámetro AsPlainText para devolver el secreto como un objeto String en su lugar, que se muestra en la consola como texto sin formato.

Ejemplo 2

Get-SecretInfo -Name Secret2 -Vault SecretStore | Get-Secret -AsPlainText

En este ejemplo se recupera información secreta del secreto denominado Secret2 en el almacén denominado SecretStore. A continuación, envía el resultado a través de la canalización a Get-Secret, que busca el secreto y lo devuelve como texto sin formato.

Parámetros

-AsPlainText

Especifica que un secreto cuyo tipo es String o SecureString debe devolverse como un string (en texto sin formato) en lugar de un SecureString. Si el secreto que se recupera no es un String o SecureString, este parámetro no tiene ningún efecto.

Cautela

Para garantizar la seguridad, debe evitar el uso de cadenas de texto no cifrado siempre que sea posible.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Especifica un objeto SecretInformation que representa un secreto de almacén en lugar de especificar los parámetros Name Name y Vault. Puede obtener un objeto SecretInformation con el cmdlet Get-SecretInfo.

Tipo:	SecretInformation
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifica el nombre del secreto que se va a recuperar. No se permiten caracteres comodín.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Vault

Especifica el nombre del almacén registrado del que se va a recuperar el secreto. Si no se especifica ningún nombre de almacén, se buscarán en todos los almacenes registrados. Si el registro del almacén tiene un almacén predeterminado y no se especifica este parámetro, se busca el almacén predeterminado antes de los demás almacenes registrados.

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

Microsoft.PowerShell.SecretManagement.SecretInformation

Salidas

Object