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
- Vous pouvez utiliser l'objet PSCredential que Get-Credential crée dans les commandlette demandant l'authentification de l'utilisateur,
telles que celles avec un paramètre Credential.
- Le paramètre Credential n'est pas pris en charge par tous les fournisseurs installés avec PowerShell. À partir de PowerShell 3.0, il est pris en charge sur certaines
commandlettes, telles que les commandlette Get-Content et New-PSDrive.
- Dans certaines situations, il est plus simple d'utiliser la commande «runas /user:» du système d'exploitation Windows.
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