Get-Credential

Obtiene un objeto de credenciales basado en un nombre de usuario y una contraseña.

Sintaxis

Get-Credential [-Credential] <PSCredential> [<CommonParameters>]

Descripción

El cmdlet Get-Credential crea un objeto de credenciales para un nombre de usuario y una contraseña especificados. Puede usar este objeto en operaciones de seguridad.

El cmdlet solicita al usuario una contraseña o un nombre de usuario y una contraseña. La solicitud a los usuarios se realiza mediante un cuadro de diálogo o en la línea de comandos, dependiendo de la configuración del Registro del sistema.

Parámetros

-Credential <PSCredential>

Especifica un nombre de usuario para la credencial, como "User01" o "Domain01\User01". El nombre del parámetro ("Credential") es opcional.

Cuando envíe el comando, se le solicitará una contraseña.

Si escribe un nombre de usuario sin un dominio, Get-Credential insertará una barra diagonal inversa delante del nombre.

Si omite este parámetro, se le pedirá un nombre de usuario y una contraseña.

¿Requerido?	true
¿Posición?	1
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas	Ninguno No se pueden canalizar entradas a este cmdlet.
Salidas	System.Management.Automation.PSCredential Get-Credential devuelve un objeto de credenciales.

Notas

Puede usar el objeto PSCredential que Get-Credential crea en cmdlets que soliciten la autenticación de usuarios, como los que tienen el parámetro Credential.

El parámetro Credential no es compatible con los proveedores que se instalan con Windows PowerShell. No obstante, puede usar el parámetro Credential con Get-WmiObject, ya que llama a Microsoft .NET Framework directamente.

Ejemplo 1

C:\PS>$c = Get-Credential

Descripción
-----------
Este comando obtiene un objeto de credenciales y lo guarda en la variable $c. 

Al especificar el comando, aparece un cuadro de diálogo que solicita un nombre de usuario y una contraseña. Cuando escriba la información solicitada, el cmdlet creará un objeto PSCredential que representa las credenciales del usuario y las guarda en la variable $c. 

Puede usar el objeto como entrada para cmdlets que soliciten la autenticación de usuarios, como los que tienen el parámetro Credential. No obstante, los proveedores que se instalan con Windows PowerShell no admiten el parámetro Credential.

Ejemplo 2

C:\PS>$c = Get-Credential

C:\PS>Get-WmiObject Win32_DiskDrive -ComputerName Server01 -Credential $c

Descripción
-----------
Estos comandos usan un objeto de credenciales de Get-Credential para autenticar a usuarios en equipos remotos de manera que puedan usar Instrumental de administración de Windows (WMI) para administrar los equipos.

El primer comando obtiene un objeto de credenciales y lo guarda en la variable $c. El segundo comando usa el objeto de credenciales en el comando Get-WmiObject. Este comando obtiene información sobre las unidades de disco del equipo Server01.

Ejemplo 3

C:\PS>C:\PS>Get-WmiObject Win32_BIOS -ComputerName Server01 '
-Credential (get-credential Domain01\User01)

Descripción
-----------
Este comando muestra cómo incluir un comando Get-Credential en un comando Get-WmiObject.

Este comando usa el cmdlet Get-WmiObject para obtener información sobre el BIOS del equipo Server01. Usa el parámetro Credential para autenticar al usuario (Domain01\User01) y el comando Get-Credential como valor del parámetro Credential.

Ejemplo 4

C:\PS>$c = Get-Credential -credential User01

C:\PS>$c.Username

\User01

Descripción
-----------
Este ejemplo crea una credencial que incluye un nombre de usuario sin un nombre de dominio. Muestra que Get-Credential inserta una barra diagonal inversa delante del nombre de usuario.

El primer comando obtiene una credencial con el nombre de usuario, User01, y la almacena en la variable $c.

El segundo comando muestra el valor de la propiedad Username del objeto de credencial resultante.

Ejemplo 5

C:\PS>$credential = $host.ui.PromptForCredential("Need credentials", "Please enter your user name and password.", "", "NetBiosUserName")

Descripción
-----------
Este comando utiliza el método PromptForCredential para solicitar al usuario su nombre de usuario y su contraseña. El comando guarda las credenciales resultantes en la variable $credential.

PromptForCredential es una alternativa al uso de Get-Credential. Al utilizar PromptForCredential, puede especificar el título, los mensajes y el nombre de usuario que aparecen en el cuadro de mensaje.

Ejemplo 6

C:\PS>Set-ItemProperty 'HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds' ConsolePrompting $true

Descripción
-----------
Si se requiere un nombre de usuario y una contraseña, como valor predeterminado, aparecerá un cuadro de diálogo para solicitar información al usuario. Para recibir solicitudes en la línea de comandos, modifique el Registro ejecutando este comando en Windows PowerShell como administrador.

Utilice el mismo comando con "ConsolePrompting $false" para recibir solicitudes con un cuadro de diálogo.