Get-Credential
Ruft ein Objekt mit Anmeldeinformationen entsprechend einem Benutzernamen und Kennwort ab.
Syntax
Get-Credential [-Credential] <PSCredential> [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Get-Credential" wird ein Objekt mit Anmeldeinformationen für einen angegebenen Benutzernamen und ein angegebenes Kennwort erstellt. Das Objekt mit Anmeldeinformationen kann in Sicherheitsvorgängen verwendet werden.
Mit dem Cmdlet werden Benutzer aufgefordert, ein Kennwort bzw. einen Benutzernamen und ein Kennwort anzugeben. Je nach Systemeinstellung der Registrierung werden Benutzer in einem Dialogfeld oder über die Befehlszeile aufgefordert.
Parameter
-Credential <PSCredential>
Gibt einen Benutzernamen für die Anmeldeinformationen wie "Benutzer01" oder "Domäne01\Benutzer01" an. Der Parametername ("Credential") ist optional.
Wenn Sie den Befehl senden, werden Sie zur Eingabe eines Kennworts aufgefordert.
Wenn Sie einen Benutzernamen ohne Domäne eingeben, wird von Get-Credential ein umgekehrter Schrägstrich vor dem Namen eingefügt.
Wenn Sie diesen Parameter auslassen, werden Sie zur Eingabe eines Benutzernamens und eines Kennworts aufgefordert.
Erforderlich? |
true |
Position? |
1 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
Eingaben |
Keiner Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden. |
Ausgaben |
System.Management.Automation.PSCredential Get-Credential gibt ein Objekt mit Anmeldeinformationen zurück. |
Hinweise
Sie können das PSCredential-Objekt verwenden, das mit Get-Credential in Cmdlets erstellt wird, die eine Benutzerauthentifizierung erfordern, z. B. Cmdlets mit einem Parameter für Anmeldeinformationen.
Der Credential-Parameter wird von den mit Windows PowerShell installierten Anbietern nicht unterstützt. Sie können den Credential-Parameter jedoch mit Get-WmiObject verwenden, da Microsoft .NET Framework in diesem Fall direkt aufgerufen wird.
Beispiel 1
C:\PS>$c = Get-Credential
Beschreibung
-----------
Mit diesem Befehl wird ein Objekt mit Anmeldeinformationen abgerufen und in der Variablen "$c" gespeichert.
Wenn Sie den Befehl eingeben, wird ein Dialogfeld zur Eingabe eines Benutzernamens und eines Kennworts angezeigt. Nachdem Sie die erforderlichen Informationen eingegeben haben, wird vom Cmdlet ein PSCredential-Objekt für die Anmeldeinformationen des Benutzers erstellt und in der Variablen "$c" gespeichert.
Sie können das Objekt als Eingabe für Cmdlets verwenden, die eine Benutzerauthentifizierung erfordern, z. B. Cmdlets mit Credential-Parameter. Der Credential-Parameter wird jedoch von den mit Windows PowerShell installierten Anbietern nicht unterstützt.
Beispiel 2
C:\PS>$c = Get-Credential
C:\PS>Get-WmiObject Win32_DiskDrive -ComputerName Server01 -Credential $c
Beschreibung
-----------
Diese Befehle verwenden ein Objekt mit Anmeldeinformationen von Get-Credential, um Benutzer auf einem Remotecomputer zu authentifizieren, sodass diese den Computer mit der Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) verwalten können.
Mit dem ersten Befehl wird ein Objekt mit Anmeldeinformationen abgerufen und in der Variablen "$c" gespeichert. Im zweiten Befehl wird das Objekt mit Anmeldeinformationen im Befehl "Get-WmiObject" verwendet. Mit diesem Befehl werden Informationen über die Laufwerke auf dem Computer "Server01" abgerufen.
Beispiel 3
C:\PS>C:\PS>Get-WmiObject Win32_BIOS -ComputerName Server01 '
-Credential (get-credential Domain01\User01)
Beschreibung
-----------
Dieser Befehl veranschaulicht, wie ein Get-Credential-Befehl in einen Get-WmiObject-Befehl eingeschlossen wird.
Mit diesem Befehl werden unter Verwendung des Cmdlets "Get-WmiObject" Informationen über das BIOS auf dem Computer "Server01" abgerufen. Der Credential-Parameter wird zur Authentifizierung des Benutzers "Domain01\User01" und der Befehl "Get-Credential" wird als Wert für den Credential-Parameter verwendet.
Beispiel 4
C:\PS>$c = Get-Credential -credential User01
C:\PS>$c.Username
\User01
Beschreibung
-----------
In diesem Beispiel werden Anmeldeinformationen erstellt, die einen Benutzernamen ohne Domänennamen einschließen. Im Beispiel wird veranschaulicht, dass von Get-Credential vor dem Benutzernamen ein umgekehrter Schrägstrich eingefügt wird.
Im ersten Befehl werden Anmeldeinformationen mit dem Benutzernamen "User01" abgerufen und in der Variablen "$c" gespeichert.
Im zweiten Befehl wird der Wert der Username-Eigenschaft des erhaltenen Objekts mit Anmeldeinformationen angezeigt.
Beispiel 5
C:\PS>$credential = $host.ui.PromptForCredential("Need credentials", "Please enter your user name and password.", "", "NetBiosUserName")
Beschreibung
-----------
In diesem Befehl werden Benutzer mit der PromptForCredential-Methode aufgefordert, ihren Benutzernamen und ihr Kennwort einzugeben. Die erhaltenen Anmeldeinformationen werden vom Befehl in der Variablen "$credential" gespeichert.
Anstelle von Get-Credential kann auch PromptForCredential verwendet werden. Wenn Sie PromptForCredential verwenden, können Sie die Beschriftung, die Meldungen und den Benutzernamen angeben, die im Meldungsfeld angezeigt werden.
Beispiel 6
C:\PS>Set-ItemProperty 'HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds' ConsolePrompting $true
Beschreibung
-----------
Wenn standardmäßig die Eingabe eines Benutzernamens und eines Kennworts gefordert wird, wird ein entsprechendes Dialogfeld angezeigt. Wenn eine Aufforderung in der Befehlszeile ausgegeben werden soll, ändern Sie die Registrierung, indem Sie diesen Befehl in Windows PowerShell mit der Option "Als Administrator ausführen" ausführen.
Verwenden Sie denselben Befehl mit "ConsolePrompting $false", wenn eine Aufforderung in einem Dialogfeld ausgegeben werden soll.