Get-Credential

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

Get-Credential
    [[-UserName] <String>]
    -Message <String>
    [<CommonParameters>]

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

A partir de PowerShell 3.0, puede usar el parámetro Message para especificar un mensaje personalizado en el cuadro de diálogo que solicita al usuario su nombre y contraseña.

El cmdlet Get-Credential solicita al usuario una contraseña o un nombre de usuario y una contraseña. De forma predeterminada, aparece un cuadro de diálogo de autenticación para preguntar al usuario. Sin embargo, en algunos programas host, como la consola de PowerShell, puede preguntar al usuario en la línea de comandos cambiando una entrada del Registro. Para obtener más información sobre esta entrada del Registro, consulte las notas y ejemplos.

$c = Get-Credential

Este comando obtiene un objeto de credencial y lo guarda en la variable $c.

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

Puede usar el objeto como entrada para los cmdlets que solicitan autenticación de usuario, como los que tienen un parámetro Credential. Sin embargo, algunos proveedores instalados con PowerShell no admiten el parámetro Credential.

$c = Get-Credential -Credential User01
$c.Username
User01

En este ejemplo se crea una credencial que incluye un nombre de usuario sin un nombre de dominio.

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 nombre de usuario del objeto de credencial resultante.

$Credential = $Host.UI.PromptForCredential("Need credentials", "Please enter your user name and password.", "", "NetBiosUserName")

Este comando usa el método PromptForCredential para solicitar al usuario su nombre de usuario y contraseña. El comando guarda las credenciales resultantes en la variable $Credential.

El método PromptForCredential es una alternativa al uso del cmdlet Get-Credential. Al usar PromptForCredential, puede especificar el título, los mensajes y el nombre de usuario que aparecen en el cuadro de mensaje.

Para obtener más información, consulte la documentación de PromptForCredential en el SDK.

Set-ItemProperty "HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds" -Name ConsolePrompting -Value $true

En este ejemplo se muestra cómo modificar el Registro para que se le solicite al usuario en la línea de comandos, en lugar de usar un cuadro de diálogo.

El comando crea el ConsolePrompting entrada del Registro y establece su valor en True. Para ejecutar este comando, inicie PowerShell con la opción "Ejecutar como administrador".

Para usar un cuadro de diálogo para preguntar, establezca el valor de ConsolePrompting en false ($false) o use el cmdlet Remove-ItemProperty para eliminarlo.

La entrada del Registro ConsolePrompting funciona en algunos programas host, como la consola de PowerShell. Es posible que no funcione en todos los programas host.

En este ejemplo se muestra cómo crear un objeto de credencial idéntico al devuelto por Get-Credential.

$User = "Domain01\User01"
$PWord = Read-Host -Prompt 'Enter a Password' -AsSecureString
$Credential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $User, $PWord

El primer comando asigna el nombre de usuario a la variable $User. Asegúrese de que el valor sigue el formato "Dominio\Usuario" o "NombreDeEquipo\Usuario".

El segundo comando usa el cmdlet Read-Host para crear una cadena segura a partir de la entrada del usuario. El parámetro Prompt solicita la entrada del usuario y el parámetro AsSecureString enmascara la entrada y lo convierte en una cadena segura.

El tercer comando usa el cmdlet New-Object para crear un objeto de PSCredential a partir de los valores almacenados en las variables $User y $PWord.

Get-Credential -Message "Credential are required for access to the \\Server1\Scripts file share." -User Server01\PowerUser

PowerShell Credential Request
Credential are required for access to the \\Server1\Scripts file share.
Password for user Server01\PowerUser:

Este comando usa los parámetros Message y UserName del cmdlet Get-Credential. Este formato de comando está diseñado para scripts y funciones compartidos. En este caso, el mensaje indica al usuario por qué se necesitan las credenciales y les da la confianza de que la solicitud es legítima.

Invoke-Command -ComputerName Server01 {Get-Credential Domain01\User02}

PowerShell Credential Request : PowerShell Credential Request
Warning: This credential is being requested by a script or application on the SERVER01 remote computer. Enter your credentials only if you
 trust the remote computer and the application or script requesting it.

Enter your credentials.
Password for user Domain01\User02: ***************

PSComputerName     : Server01
RunspaceId         : 422bdf52-9886-4ada-ab2f-130497c6777f
PSShowComputerName : True
UserName           : Domain01\User01
Password           : System.Security.SecureString

Este comando obtiene una credencial del equipo remoto Server01. El comando usa el cmdlet Invoke-Command para ejecutar un comando Get-Credential en el equipo remoto. La salida muestra el mensaje de seguridad remota que Get-Credential incluye en el mensaje de autenticación.

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.

No se pueden canalizar objetos a este cmdlet.

Este cmdlet devuelve un objeto de credencial.

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

De forma predeterminada, el mensaje de autenticación aparece en un cuadro de diálogo. Para mostrar el símbolo del sistema de autenticación en la línea de comandos, agregue el ConsolePrompting entrada del Registro (HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\ConsolePrompting) y establezca su valor en True. Si la ConsolePrompting entrada del Registro no existe o si su valor es False, el símbolo del sistema de autenticación aparece en un cuadro de diálogo. Para obtener instrucciones, consulte los ejemplos.

La ConsolePrompting entrada del Registro funciona en la consola de PowerShell, pero no funciona en todos los programas host.

Por ejemplo, no tiene ningún efecto en el entorno de scripting integrado (ISE) de PowerShell. Para obtener información sobre el efecto de la entrada del Registro de ConsolePrompting, consulte los temas de ayuda del programa host.

El parámetro Credential no es compatible con todos los proveedores instalados con PowerShell. A partir de PowerShell 3.0, se admite en ciertos cmdlets seleccionados, como los cmdlets Get-Content y New-PSDrive.