Get-Credential

Syntax

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

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

Description

Cmdleten Get-Credential skapar ett autentiseringsobjekt för ett angivet användarnamn och lösenord. Du kan använda autentiseringsobjektet i säkerhetsåtgärder.

Cmdleten Get-Credential uppmanar användaren att ange ett lösenord eller ett användarnamn och lösenord. Du kan använda parametern Message för att ange ett anpassat meddelande i kommandotolken.

Exempel

Exempel 1

$c = Get-Credential

Det här kommandot hämtar ett autentiseringsobjekt och sparar det i variabeln $c.

När du anger kommandot uppmanas du att ange ett användarnamn och lösenord. När du anger den begärda informationen skapar cmdleten ett PSCredential- objekt som representerar användarens autentiseringsuppgifter och sparar den i variabeln $c.

Du kan använda objektet som indata för cmdletar som begär användarautentisering, till exempel de med en autentiseringsuppgifter parameter. Vissa leverantörer som är installerade med PowerShell stöder dock inte parametern Credential.

Exempel 2

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

I det här exemplet skapas en autentiseringsuppgift som innehåller ett användarnamn utan domännamn.

Det första kommandot hämtar en autentiseringsuppgift med användarnamnet User01 och lagrar den i variabeln $c. Det andra kommandot visar värdet för egenskapen Username för det resulterande autentiseringsobjektet.

Exempel 3

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

Det här kommandot använder metoden PromptForCredential för att fråga användaren om deras användarnamn och lösenord. Kommandot sparar de resulterande autentiseringsuppgifterna i variabeln $Credential.

Metoden PromptForCredential är ett alternativ till att använda cmdleten Get-Credential. När du använder PromptForCredentialkan du ange undertexten, meddelandena och användarnamnet som visas i prompten.

Mer information finns i dokumentationen PromptForCredential i SDK.

Exempel 4

Det här exemplet visar hur du skapar ett autentiseringsobjekt som är identiskt med det objekt som Get-Credential returnerar utan att fråga användaren. Den här metoden kräver ett lösenord för oformaterad text som kan strida mot säkerhetsstandarderna i vissa företag.

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

Det första kommandot sparar användarnamnet i parametern $User. Värdet måste ha formatet "Domain\User" eller "ComputerName\User".

Det andra kommandot använder cmdleten ConvertTo-SecureString för att skapa en säker sträng från ett lösenord för oformaterad text. Kommandot använder parametern AsPlainText för att indikera att strängen är oformaterad text och parametern Force för att bekräfta att du förstår riskerna med att använda oformaterad text.

Det tredje kommandot använder cmdleten New-Object för att skapa ett PSCredential- objekt från värdena i variablerna $User och $PWord.

Exempel 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:

Det här kommandot använder parametrarna Message och UserName för cmdleten Get-Credential. Det här kommandoformatet är utformat för delade skript och funktioner. I det här fallet meddelar meddelandet användaren varför autentiseringsuppgifter behövs och ger dem förtroende för att begäran är legitim.

Exempel 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

Det här kommandot hämtar en autentiseringsuppgift från server01-fjärrdatorn. Kommandot använder cmdleten Invoke-Command för att köra ett Get-Credential kommando på fjärrdatorn. Utdata visar fjärrsäkerhetsmeddelandet som Get-Credential innehåller i autentiseringsprompten.

Parametrar

-Credential

-Message

-Title

-UserName

Indata

None

Du kan inte skicka indata till den här cmdleten.

Utdata

PSCredential

Get-Credential returnerar ett autentiseringsobjekt.

Kommentarer

Du kan använda PSCredential- objekt som Get-Credential skapar i cmdletar som begär användarautentisering, till exempel de med en autentiseringsuppgift parameter.

Parametern Credential stöds inte av alla leverantörer som är installerade med PowerShell. Från och med PowerShell 3.0 stöds det på utvalda cmdletar, till exempel cmdletarna Get-Content och New-PSDrive.

Relaterade länkar

• PromptForCredential