IWSManConnectionOptions::get_UserName-Methode (wsmandisp.h)
Legt fest und ruft den Benutzernamen eines lokalen kontos oder eines Domänenkontos auf dem Remotecomputer ab. Diese Eigenschaft bestimmt den Benutzernamen für die Authentifizierung. Wenn kein Wert angegeben wird und das WSManFlagCredUsernamePassword-Flag nicht festgelegt ist, wird der Benutzername des Kontos verwendet, auf dem das Skript ausgeführt wird.
Wenn das WSManFlagCredUsernamePassword-Flag festgelegt ist, aber kein Benutzername angegeben ist, fordert das Skript den Benutzer auf, den Benutzernamen und das Kennwort einzugeben. Wenn kein Benutzername und kein Kennwort eingegeben werden, wird ein Fehler vom Typ "Zugriff verweigert" zurückgegeben. Weitere Informationen finden Sie unter Authentifizierung für Remote-Connections.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT get_UserName(
BSTR *name
);
Parameter
name
Rückgabewert
Keine
Bemerkungen
Sie können Benutzername und Kennwort für ein Domänenkonto angeben, wenn Sie die Aushandlungs- oder Kerberos-Authentifizierung oder ein lokales Konto mit Standardauthentifizierung verwenden. Um eine Verbindung mit einem lokalen Konto herzustellen, müssen die WSMan.CreateSession-Flags die Kombination aus dem WSManFlagUseBasic-Flag und dem WsmanFlagCredUserNamePassword-Flag enthalten. Um eine Verbindung mit einem Domänenkonto herzustellen, müssen die WSMan.CreateSession-Flags die Kombination aus dem WSManFlagUseNegotiate-Flag und dem WsmanFlagCredUserNamePassword-Flag oder die Kombination des WSManFlagUseKerberos-Flags und des WsmanFlagCredUserNamePassword-Flags enthalten. Für ein Domänenkonto muss UserName im Format "computer\username" angegeben werden, wobei der "Computer"-Teil der Zeichenfolge entweder der Name oder die IP-Adresse sein kann. Weitere Informationen finden Sie unter Authentifizierung für Remote-Connections.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | wsmandisp.h |
| Bibliothek | WSManDisp.tlb |
| DLL | WSMAuto.dll |