Section courante

A propos

Section administrative du site

Get-Credential

Demande l'authentification
PowerShell

Syntaxe

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

Paramètres

Nom Description
-Credential Ce paramètre permet d'indiquer un nom d'utilisateur pour les informations d'identification, tel que User01 ou Domain01\User01. Le nom du paramètre, -Credential, est facultatif. Lorsque vous soumettez la commande et spécifiez un nom d'utilisateur, vous êtes invité à entrer un mot de passe. Si vous omettez ce paramètre, vous êtes invité à entrer un nom d'utilisateur et un mot de passe. À partir de PowerShell 3.0, si vous entrez un nom d'utilisateur sans domaine, Get-Credential n'insère plus de barre oblique inverse avant le nom. Les informations d'identification sont entreposées dans un objet PSCredential et le mot de passe est entreposé en tant que SecureString.
-Message Ce paramètre permet d'indiquer un message apparaissant dans le prompt d'authentification. Ce paramètre est conçu pour être utilisé dans une fonction ou un script. Vous pouvez utiliser le message pour expliquer à l'utilisateur pourquoi vous demandez des informations d'identification et comment elles seront utilisées. Ce paramètre a été introduit dans PowerShell 3.0.
-Title Ce paramètre permet de définir le texte de la ligne de titre du prompt d'authentification dans la console. Ce paramètre a été introduit dans PowerShell 6.0.
-UserName Ce paramètre permet d'indiquer un nom d'utilisateur. Le prompt d'authentification demande un mot de passe pour le nom d'utilisateur. Par défaut, le nom d'utilisateur est vide et le prompt d'authentification demande à la fois un nom d'utilisateur et un mot de passe. Ce paramètre a été introduit dans PowerShell 3.0.

Description

Cette commande permet de demander un objet d'identification basé sur un nom d'utilisateur et un mot de passe.

Remarques

Exemple

L'exemple suivant permet de créer une variable «$cred» avec une session PowerShell de l'un utilisateur «TESTUSER» :

$cred = Get-Credential -UserName 'TESTUSER' -Message ' '


Dernière mise à jour : Mardi, le 12 Janvier 2021