Get-Credential

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

Sintassi

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

Descrizione

Il cmdlet Get-Credential crea un oggetto credenziale per un nome utente e una password specificati. Tale oggetto credenziale può essere utilizzato nelle operazioni in cui è richiesta la sicurezza.

Il cmdlet richiede all'utente una password o un nome utente e una password. La richiesta viene visualizzata tramite una finestra di dialogo o sulla riga di comando, a seconda dell'impostazione del Registro di sistema.

Parametri

-Credential <PSCredential>

Specifica un nome utente per la credenziale, ad esempio "Utente01" o "Dominio01\Utente01". Il nome del parametro ("Credential") è facoltativo.

Quando si invia il comando, viene richiesta una password.

Se si immette un nome utente senza un dominio, Get-Credential inserisce una barra rovesciata prima del nome.

Se si omette questo parametro, vengono richiesti un nome utente e una password.

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Note

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

Il parametro Credential non è supportato dai provider installati con Windows PowerShell. È tuttavia possibile utilizzare il parametro Credential con Get-WmiObject, in quanto questo cmdlet chiama direttamente Microsoft .NET Framework.

Esempio 1

C:\PS>$c = Get-Credential

Descrizione
-----------
Tramite questo comando è possibile ottenere un oggetto credenziale e salvarlo nella variabile $c. 

Quando si immette il comando, viene visualizzata una finestra di dialogo in cui viene richiesto di immettere un nome utente e una password. Quando si immettono le informazioni richieste, tramite il cmdlet viene creato un oggetto PSCredential che rappresenta le credenziali dell'utente e tale oggetto viene salvato nella variabile $c. 

È possibile utilizzare l'oggetto come input per i cmdlet che richiedono l'autenticazione utente, ad esempio quelli con un parametro Credential. Il parametro Credential non è tuttavia supportato dai provider installati con Windows PowerShell.

Esempio 2

C:\PS>$c = Get-Credential

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

Descrizione
-----------
In questi comandi viene utilizzato un oggetto credenziale ottenuto da Get-Credential per autenticare un utente in un computer remoto, affinché possa utilizzare Strumentazione gestione Windows (WMI) per gestire il computer.

Tramite il primo comando è possibile ottenere un oggetto credenziale e salvarlo nella variabile $c. Nel secondo comando l'oggetto credenziale viene utilizzato in un comando Get-WmiObject. Questo comando consente di ottenere informazioni sulle unità disco nel computer Server01.

Esempio 3

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

Descrizione
-----------
Con questo comando viene illustrato come includere un comando Get-Credential in un comando Get-WmiObject.

Nel comando viene utilizzato il cmdlet Get-WmiObject per ottenere informazioni sul BIOS del computer Server01. Vengono utilizzati il parametro Credential per autenticare l'utente, Domain01\User01, e un comando Get-Credential come valore del parametro Credential.

Esempio 4

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

C:\PS>$c.Username

\User01

Descrizione
-----------
In questo comando viene creata una credenziale che include un nome utente senza un nome di dominio. Indica che Get-Credential inserisce una barra rovesciata prima del nome utente.

Con il primo comando si ottiene una credenziale con il nome utente User01 e la si archivia nella variabile $c.

Nel secondo comando viene visualizzato il valore della proprietà Username dell'oggetto credenziale risultante.

Esempio 5

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

Descrizione
-----------
Questo comando utilizza il metodo PromptForCredential per richiedere all'utente il nome utente e la password. Il comando salva le credenziali risultati nella variabile $credential.

PromptForCredential è un'alternativa all'utilizzo di Get-Credential. Quando si utilizza PromptForCredential, è possibile specificare la didascalia, i messaggi e il nome utente visualizzati nella finestra di messaggio.

Esempio 6

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

Descrizione
-----------
Per impostazione predefinita, quando vengono richiesti un nome utente e una password all'utente, viene visualizzata una finestra di dialogo. Per visualizzare la richiesta sulla riga di comando, modificare il Registro di sistema eseguendo questo comando in Esegui come amministratore di Windows PowerShell.

Utilizzare lo stesso comando, con "ConsolePrompting $false" per visualizzare la richiesta con una finestra di dialogo.