Get-Credential

  • Referencia
Modul:
Microsoft.PowerShell.Security

Lekéri a hitelesítőadat-objektumot egy felhasználónév és jelszó alapján.

Syntax

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

Description

A Get-Credential parancsmag létrehoz egy hitelesítő objektumot egy megadott felhasználónévhez és jelszóhoz. A hitelesítőadat-objektumot a biztonsági műveletekben használhatja.

A Get-Credential parancsmag jelszót vagy felhasználónevet és jelszót kér a felhasználótól. Az Üzenet paraméterrel testre szabott üzenetet adhat meg a parancssorban.

Példák

1\. példa

$c = Get-Credential

Ez a parancs lekéri a hitelesítőadat-objektumot, és menti azt a $c változóba.

A parancs megadásakor a rendszer felhasználónevet és jelszót kér. A kért adatok megadásakor a parancsmag létrehoz egy PSCredential objektumot, amely a felhasználó hitelesítő adatait jelöli, és menti azokat a $c változóba.

Az objektumot bemenetként használhatja a felhasználói hitelesítést kérő parancsmagokhoz, például a hitelesítőadat-paraméterrel rendelkező parancsmagokhoz. A PowerShell-lel telepített egyes szolgáltatók azonban nem támogatják a Hitelesítő adatok paramétert.

2\. példa

$c = Get-Credential -credential User01
$c.Username
User01

Ez a példa egy olyan hitelesítő adatot hoz létre, amely tartománynév nélküli felhasználónevet tartalmaz.

Az első parancs lekéri a User01 felhasználónévvel rendelkező hitelesítő adatokat, és tárolja azt a $c változóban. A második parancs megjeleníti az eredményként kapott hitelesítőadat-objektum Username tulajdonságának értékét.

3\. példa

$Credential = $host.ui.PromptForCredential("Need credentials", "Please enter your user name and password.", "", "NetBiosUserName")

Ez a parancs a PromptForCredential metódust használja a felhasználó felhasználónevének és jelszavának megadására. A parancs menti az eredményként kapott hitelesítő adatokat a $Credential változóban.

A PromptForCredential metódus alternatíva a Get-Credential parancsmag használata helyett. A PromptForCredential használatakor megadhatja az üzenetben megjelenő feliratot, üzeneteket és felhasználónevet.

További információ: PromptForCredential dokumentáció az SDK-ban.

4\. példa

Ez a példa bemutatja, hogyan hozhat létre olyan hitelesítőadat-objektumot, amely megegyezik a visszaadott objektummal anélkül, hogy Get-Credential a felhasználót megkérdezi. Ehhez a módszerhez egyszerű szöveges jelszó szükséges, amely egyes vállalatok biztonsági szabványait sértheti.

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

Az első parancs menti a felhasználói fiók nevét a $User paraméterben. Az értéknek "Domain\User" vagy "ComputerName\User" formátumúnak kell lennie.

A második parancs a ConvertTo-SecureString parancsmaggal hoz létre egy egyszerű szöveges jelszóból származó biztonságos sztringet. A parancs az AsPlainText paraméterrel jelzi, hogy a sztring egyszerű szöveg, a Force paraméter pedig annak ellenőrzésére, hogy tisztában van-e az egyszerű szöveg használatának kockázataival.

A harmadik parancs a New-Object parancsmaggal hoz létre egy PSCredential objektumot a és $PWord változók $User értékeiből.

5\. példa

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:

Ez a parancs a parancsmag Message és UserName paramétereit Get-Credential használja. Ez a parancsformátum megosztott szkriptekhez és függvényekhez készült. Ebben az esetben az üzenet tájékoztatja a felhasználót arról, hogy miért van szükség hitelesítő adatokra, és biztos lehet abban, hogy a kérés jogos.

6\. példa

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

Ez a parancs lekéri a hitelesítő adatokat a Server01 távoli számítógépről. A parancs a Invoke-Command parancsmaggal futtat egy Get-Credential parancsot a távoli számítógépen. A kimenet a hitelesítési kérésben szereplő távoli biztonsági üzenetet Get-Credential jeleníti meg.

Paraméterek

-Credential

Megadja a hitelesítő adat felhasználónevét, például User01 vagy Domain01\User01. A paraméter neve ( -Credential) nem kötelező.

Amikor elküldi a parancsot, és megad egy felhasználónevet, a rendszer jelszót kér. Ha kihagyja ezt a paramétert, a rendszer felhasználónevet és jelszót kér.

A PowerShell 3.0-tól kezdve, ha tartomány nélküli felhasználónevet ad meg, Get-Credential a továbbiakban nem szúr be fordított perjelet a név elé.

A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszót pedig SecureStringként tárolja a rendszer.

Megjegyzés

További információ a SecureString adatvédelméről: How secure is SecureString?.

Type:PSCredential
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Message

A hitelesítési kérésben megjelenő üzenetet adja meg. Ezt a paramétert egy függvényben vagy szkriptben való használatra tervezték. Az üzenet segítségével elmagyarázhatja a felhasználónak, hogy miért kér hitelesítő adatokat, és hogyan fogja használni őket.

Ez a paraméter a PowerShell 3.0-ban lett bevezetve.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Title

Beállítja a hitelesítési kérés címsorának szövegét a konzolon.

Ez a paraméter a PowerShell 6.0-ban lett bevezetve.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserName

Felhasználónevet ad meg. A hitelesítési kérés jelszót kér a felhasználónévhez. Alapértelmezés szerint a felhasználónév üres, és a hitelesítési kérés felhasználónevet és jelszót is kér.

Ez a paraméter a PowerShell 3.0-ban lett bevezetve.

Type:String
Position:1
Default value:None (blank)
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat átirányítani.

Kimenetek

PSCredential

Ez a parancsmag egy hitelesítőadat-objektumot ad vissza.

Jegyzetek

Használhatja a PSCredential objektumot, amely Get-Credential olyan parancsmagokban jön létre, amelyek felhasználói hitelesítést kérnek, például a hitelesítőadat-paraméterrel rendelkezőket.

A Hitelesítőadat-paramétert a PowerShell-lel telepített összes szolgáltató nem támogatja. A PowerShell 3.0-tól kezdve támogatott bizonyos parancsmagokon, például a és New-PSDrive a Get-Content parancsmagokon.