Get-Credential

Article
01/13/2010

Obtient un objet credential (informations d'identification) basé sur les nom et mot de passe d'un utilisateur.

Syntaxe

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

Description

L'applet de commande Get-Credential crée un objet credential (informations d'identification) pour un nom d'utilisateur et un mot de passe spécifiés. Vous pouvez utiliser l'objet credential dans des opérations de sécurité.

L'applet de commande invite l'utilisateur à entrer un mot de passe ou un nom d'utilisateur et un mot de passe. Pour ce faire, le système utilise une boîte de dialogue ou la ligne de commande, selon le paramètre de Registre du système.

Paramètres

-Credential <PSCredential>

Spécifie un nom d'utilisateur pour l'objet credential, comme « User01 » ou « Domain01\User01 ». Le nom de paramètre (« Credential ») est facultatif.

Lorsque vous envoyez la commande, vous êtes invité à fournir un mot de passe.

Si vous entrez un nom d'utilisateur sans un domaine, Get-Credential insère une barre oblique inverse avant le nom.

Si vous omettez ce paramètre, vous êtes invité à fournir un nom d'utilisateur et un mot de passe.

Obligatoire ?	true
Position ?	1
Valeur par défaut	aucun
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

None

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

System.Management.Automation.PSCredential

Get-Credential retourne un objet credential (informations d'identification).

Remarques

Vous pouvez utiliser l'objet PSCredential créé par Get-Credential dans les applets de commande qui requièrent l'authentification de l'utilisateur, telles que celles qui font appel à un paramètre Credential.

Le paramètre Credential n'est pas pris en charge par les fournisseurs installés avec Windows PowerShell. Toutefois, vous pouvez utiliser le paramètre Credential avec Get-WmiObject, car cette applet de commande appelle directement Microsoft .NET Framework .

Exemple 1

C:\PS>$c = Get-Credential

Description
-----------
Cette commande obtient un objet credential et l'enregistre dans la variable $c. 

Lorsque vous entrez la commande, une boîte de dialogue s'ouvre pour vous demander un nom d'utilisateur et un mot de passe. Lorsque vous fournissez les informations requises, l'applet de commande crée un objet PSCredential représentant les informations d'identification de l'utilisateur et l'enregistre dans la variable $c. 

Vous pouvez utiliser l'objet en tant qu'entrée pour des applets de commande qui requièrent l'authentification de l'utilisateur, telles celles qui font appel au paramètre Credential. Toutefois, les fournisseurs installés avec Windows PowerShell ne prennent pas en charge le paramètre Credential.

Exemple 2

C:\PS>$c = Get-Credential

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

Description
-----------
Ces commandes utilisent un objet credential (informations d'identification) de Get-Credential pour authentifier un utilisateur sur un ordinateur distant en vue de la gestion de l'ordinateur avec Windows Management Instrumentation (WMI).

La première commande obtient un objet credential et l'enregistre dans la variable $c. La deuxième commande utilise l'objet credential dans une commande Get-WmiObject. Cette commande obtient des informations sur les lecteurs de disques de l'ordinateur Server01.

Exemple 3

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

Description
-----------
Cette commande montre comment inclure une commande Get-Credential dans une commande Get-WmiObject.

Elle utilise l'applet de commande Get-WmiObject pour obtenir des informations sur le BIOS de l'ordinateur Server01. Elle utilise le paramètre Credential pour authentifier l'utilisateur, Domain01\User01, et une commande Get-Credential comme valeur du paramètre Credential.

Exemple 4

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

C:\PS>$c.Username

\User01

Description
-----------
Cet exemple crée des informations d'identification qui incluent un nom d'utilisateur sans nom de domaine. Elle montre que Get-Credential insère une barre oblique inverse avant le nom de l'utilisateur.

La première commande obtient des informations d'identification avec le nom d'utilisateur User01 et les stocke dans la variable $c.

La deuxième commande affiche la valeur de la propriété Username de l'objet d'informations d'identification résultant.

Exemple 5

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

Description
-----------
Cette commande utilise la méthode PromptForCredential pour inviter l'utilisateur à entrer son nom et son mot de passe. Elle enregistre les informations d'identification obtenues dans la variable $credential.

PromptForCredential constitue une alternative à l'utilisation de Get-Credential. Lorsque vous utilisez PromptForCredential, vous pouvez spécifier la légende, les messages et le nom d'utilisateur qui apparaît dans le message.

Exemple 6

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

Description
-----------
Lorsque, par défaut, il est nécessaire d'entrer un nom d'utilisateur et un mot de passe, une boîte de dialogue apparaît pour y inviter l'utilisateur. Pour utiliser la ligne de commande, modifiez le Registre en exécutant cette commande dans l'instance d'exécution Windows PowerShell, en tant qu'administrateur.

Utilisez la même commande avec « ConsolePrompting $false » pour afficher une boîte de dialogue.

Partager via