Condividi tramite

Get-Credential

Modulo:
Microsoft.PowerShell.Security Module

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

Sintassi

CredentialSet (Impostazione predefinita) 

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

MessageSet 

Get-Credential
    [[-UserName] <String>]
    [-Message <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 utilizzare il parametro Message per specificare un messaggio personalizzato nel prompt della riga di comando.

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 credenziali identico all'oggetto restituito Get-Credential senza chiedere conferma all'utente. Questo metodo richiede una password in testo normale, che potrebbe violare gli standard di sicurezza di alcune aziende.

$User = "Domain01\User01"
$PWord = ConvertTo-SecureString -String "P@sSwOrd" -AsPlainText -Force
$Credential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $User, $PWord

Il primo comando salva il nome dell'account utente nel $User parametro. Il valore deve avere il formato "Dominio\Utente" o "NomeComputer\Utente".

Il secondo comando usa il ConvertTo-SecureString cmdlet per creare una stringa sicura da una password di testo normale. Il comando utilizza il parametro AsPlainText per indicare che la stringa è testo normale e il parametro Force per confermare che si comprendono i rischi derivanti dall'uso di testo normale.

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

Esempio 5

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:

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 {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.

Annotazioni

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

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

CredentialSet
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

MessageSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Title

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

Questo parametro è stato introdotto in PowerShell 6.0.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

MessageSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None (blank)
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

MessageSet
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Non è possibile inviare tramite pipe l'input a questo cmdlet.

Output

PSCredential

Get-Credential 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.