ConnectionOptions-Objekt

Das ConnectionOptions-Objekt wird an die CreateSession-Methode übergeben, um den Benutzernamen und das Kennwort für das lokale Konto auf dem Remotecomputer einzugeben. Wenn keine Parameter angegeben werden, werden die Anmeldeinformationen des Kontos, das das Skript ausgeführt, auf die Standardwerte festgelegt.

Member

Das ConnectionOptions-Objekt verfügt über die folgenden Membertypen:

Eigenschaften

Das ConnectionOptions-Objekt verfügt über diese Eigenschaften.

Eigenschaft Zugriffstyp Beschreibung
Kennwort
Lesegeschützt
Legt das Kennwort eines lokalen Kontos oder Domänenkontos auf dem Remotecomputer fest.
Nutzername
Lesen/Schreiben
Legt den Benutzernamen eines lokalen Kontos oder eines Domänenkontos auf dem Remotecomputer fest und ruft den Benutzernamen ab.

Hinweise

Das ConnectionOptions-Objekt entspricht der IWSManConnectionOptions-Schnittstelle.

Wenn eine Windows Remoteverwaltungsclientanwendung unter Identitätswechsel ausgeführt wird, tritt ein Fehler auf, wenn Sie die Password-Eigenschaft festlegen. Eine Clientanwendung ist ein Skript oder ein anderes Programm, das eine Anforderung an WinRM auf dem lokalen oder einem Remotecomputer sendet. Die Clientanwendung wird möglicherweise unter Identitätswechsel ausgeführt, da sie eine Funktion wie ImpersonateClient aufgerufen hat. Eine Active Server-Seite (ASP) oder ein Dienst kann keinen Benutzernamen und kein Kennwort anfordern, wenn der ASP-Prozess unter einem Konto ausgeführt wird, das die Identität eines Clients anfing.

Das WSManFlagCredUserNamePassword-Flag sollte für den WSman.CreateSession-Aufruf festgelegt werden, wenn UserName und Password für die Authentifizierung verwendet werden.

Beispiele

Im folgenden VBScript-Codebeispiel wird veranschaulicht, wie Sie ein ConnectionOptions-Objekt erstellen, die Eigenschaften für das Konto auf dem Remotecomputer festlegen und es zum Erstellen eines Session-Objekts verwenden.

Set objWsman = CreateObject( "Wsman.Automation" )
'Create ConnectionOptions object.
Set objConnectionOptions = objWsman.CreateConnectionOptions
objConnectionOptions.UserName = "johns "
objConnectionOptions.Password = "Dtf#4542?98"
iFlags = objWsman.SessionFlagUseBasic Or _
  objWsman.SessionFlagCredUserNamePassword
Set objSession = objWsman.CreateSession _
  ("https://172.30.168.2", iFlags, objConnectionOptions)
strResource = objSession.Get("winrm/config")

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Header
WSManDisp.h
Idl
WSManDisp.idl
Bibliothek
WSManDisp.tlb
DLL
WSMAuto.dll

Siehe auch

Authentifizierung für Remoteverbindungen

WinRM-Skripterstellungs-API

Informationen Windows Remoteverwaltung

Verwenden Windows Remoteverwaltung

Skripterstellung in Windows Remoteverwaltung

Abrufen von Daten vom lokalen Computer

Abrufen von Daten von einem Remotecomputer