Condividi tramite

Get-Credential

  • Riferimento
Modulo:
Microsoft.PowerShell.Security

Ottiene un oggetto credenziale basato su un nome utente e una password.

Sintassi

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

Descrizione

Il cmdlet Get-Credential crea un oggetto credenziali per un nome utente e una password specificati. È possibile usare l'oggetto credenziale nelle operazioni di sicurezza.

Il cmdlet Get-Credential richiede all'utente una password o un nome utente e una password. È possibile usare il parametro Message per specificare un messaggio personalizzato per il prompt.

In Windows PowerShell 5.1 e versioni precedenti, Windows visualizza una finestra di dialogo per richiedere un nome utente e una password. In PowerShell 6.0 e versioni successive, il prompt viene visualizzato nella console per tutte le piattaforme.

Esempio

Esempio 1

$c = Get-Credential

Questo comando ottiene un oggetto credenziale e lo salva nella variabile $c.

Quando si immette il comando, viene richiesto un nome utente e una password. Quando si immettono le informazioni richieste, il cmdlet crea un oggetto PSCredential che rappresenta le credenziali dell'utente e lo salva nella variabile $c.

È possibile usare l'oggetto come input per i cmdlet che richiedono l'autenticazione utente, ad esempio quelli con un parametro Credential. Tuttavia, alcuni provider installati con PowerShell non supportano il parametro Credential.

Esempio 2

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

In questo esempio viene creata una credenziale che include un nome utente senza un nome di dominio.

Il primo comando ottiene una credenziale con il nome utente User01 e lo archivia nella variabile $c. Il secondo comando visualizza il valore della proprietà Username dell'oggetto credenziale risultante.

Esempio 3

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

Questo comando usa il metodo promptforcredential per richiedere all'utente il nome utente e la password. Il comando salva le credenziali risultanti nella variabile $Credential.

Il metodo PromptForCredential è un'alternativa all'uso del cmdlet Get-Credential. Quando si usa PromptForCredential, è possibile specificare la didascalia, i messaggi e il nome utente visualizzati nel prompt.

Per altre informazioni, vedere la documentazione PromptForCredential nell'SDK.

Esempio 4

In questo esempio viene illustrato come creare un oggetto credenziale identico a quello restituito da Get-Credential.

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

Il primo comando assegna il nome utente alla variabile $User. Verificare che il valore segua il formato "Domain\User" o "ComputerName\User".

Il secondo comando usa il cmdlet Read-Host per creare una stringa sicura dall'input dell'utente. Il parametro prompt richiede l'input dell'utente e il parametro AsSecureString maschera l'input e lo converte in una stringa sicura.

Il terzo comando usa il cmdlet New-Object per creare un oggetto PSCredential dai valori archiviati nelle variabili $User e $PWord.

Esempio 5

$credentialParams = @{
    Message = "Credential are required for access to the \\Server1\Scripts file share."
    UserName = "Server01\PowerUser"
}
Get-Credential @credentialParams

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

Questo comando utilizza i parametri Message e UserName del cmdlet Get-Credential. Questo formato di comando è progettato per script e funzioni condivisi. In questo caso, il messaggio indica all'utente perché sono necessarie le credenziali e garantisce che la richiesta sia legittima.

Esempio 6

Invoke-Command -ComputerName Server01 -ScriptBlock {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

Questo comando ottiene una credenziale dal computer remoto Server01. Il comando usa il cmdlet Invoke-Command per eseguire un comando Get-Credential nel computer remoto. L'output mostra il messaggio di sicurezza remoto che Get-Credential include nella richiesta di autenticazione.

Parametri

-Credential

Specifica un nome utente per le credenziali, ad esempio User01 o Domain01\User01. Il nome del parametro, -Credential, è facoltativo.

Quando si invia il comando e si specifica un nome utente, viene richiesta una password. Se si omette questo parametro, viene richiesto un nome utente e una password.

A partire da PowerShell 3.0, se si immette un nome utente senza un dominio, Get-Credential non inserisce più una barra rovesciata prima del nome.

Le credenziali vengono archiviate in un oggetto PSCredential e la password viene archiviata come SecureString.

Nota

Per ulteriori informazioni sulla protezione dei dati di SecureString, vedere Quanto è sicuro SecureString?.

Tipo:PSCredential
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Message

Specifica un messaggio visualizzato nel prompt di autenticazione. Questo parametro è progettato per l'uso in una funzione o in uno script. È possibile usare il messaggio per spiegare all'utente perché si richiedono le credenziali e come verranno usate.

Questo parametro è stato introdotto in PowerShell 3.0.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Title

Imposta il testo della riga del titolo per il prompt di autenticazione nella console.

Questo parametro è stato introdotto in PowerShell 6.0.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserName

Specifica un nome utente. La richiesta di autenticazione richiede una password per il nome utente. Per impostazione predefinita, il nome utente è vuoto e il prompt di autenticazione richiede sia un nome utente che una password.

Questo parametro è stato introdotto in PowerShell 3.0.

Tipo:String
Posizione:1
Valore predefinito:None (blank)
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

PSCredential

Questo cmdlet restituisce un oggetto credenziale.

Note

È possibile usare l'oggetto PSCredential creato Get-Credential nei cmdlet che richiedono l'autenticazione utente, ad esempio quelli con un parametro Credential.

Il parametro credenziale non è supportato da tutti i provider installati con PowerShell. A partire da PowerShell 3.0, è supportato nei cmdlet select, ad esempio i cmdlet Get-Content e New-PSDrive.