ConnectionOptions-Objekt

Das ConnectionOptions-Objekt wird an die CreateSession-Methode übergeben, um den Benutzernamen und das Kennwort anzugeben, die dem lokalen Konto auf dem Remotecomputer zugeordnet sind. Wenn keine Parameter angegeben werden, werden die Anmeldeinformationen des Kontos, auf dem das Skript ausgeführt wird, 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 Oder Domänenkontos auf dem Remotecomputer fest.
Nutzername
Lesen/Schreiben
Legt fest und ruft den Benutzernamen eines lokalen Kontos oder Domänenkontos auf dem Remotecomputer ab.

Bemerkungen

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 Page (ASP) oder ein Dienst kann keinen Benutzernamen und ein Kennwort anfordern, wenn der ASP-Prozess unter einem Konto ausgeführt wird, das die Identität eines Clients angibt.

Das WSManFlagCredUserNamePassword-Flag sollte für den WSman.CreateSession-Aufruf festgelegt werden, wenn der Benutzername und das Kennwort für die Authentifizierung verwendet werden.

Beispiele

Das folgende VBScript-Codebeispiel zeigt, 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)
WindowsServer 2008
Header
WSManDisp.h
IDL
WSManDisp.idl
Bibliothek
WSManDisp.tlb
DLL
WSMAuto.dll

Weitere Informationen

Authentifizierung für Remoteverbindungen

WinRM-Skript-API

Informationen zur Windows-Remoteverwaltung

Verwenden der Windows-Remoteverwaltung

Skripterstellung in der Windows-Remoteverwaltung

Abrufen von Daten vom lokalen Computer

Abrufen von Daten von einem Remotecomputer