Freigeben über


ConnectionOptions-Objekt

Das ConnectionOptions-Objekt wird an die CreateSession-Methode übergeben, um den Benutzernamen und das Kennwort anzugeben, das dem lokalen Konto auf dem Remotecomputer zugeordnet ist. Wenn keine Parameter angegeben werden, werden die Anmeldeinformationen des Kontos, das das Skript ausführt, auf die Standardwerte festgelegt.

Elemente

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

Eigenschaften

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

Eigentum Zugriffstyp BESCHREIBUNG
Kennwort
Nur schreiben
Legt das Kennwort eines lokalen oder Domänenkontos auf dem Remotecomputer fest.
UserName-
Lesen/Schreiben
Legt fest und ruft den Benutzernamen eines lokalen 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 Remotecomputer sendet. Die Clientanwendung kann unter Identitätswechsel ausgeführt werden, 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 einen Client imitiert.

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 Ein ConnectionOptions-Objekt erstellt, die Eigenschaften für das Konto auf dem Remotecomputer festgelegt und beim Erstellen eines Session-Objekts verwendet werden. Hinweis: Speichern Sie keine Anmeldeinformationen im Nur-Text-Format in Skriptdateien.

Set objWsman = CreateObject( "Wsman.Automation" )
'Create ConnectionOptions object.
Set objConnectionOptions = objWsman.CreateConnectionOptions
objConnectionOptions.UserName = "<username>"
objConnectionOptions.Password = "<password>"
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
Mindest unterstützter Client
Windows Vista
Unterstützter Server (Mindestversion)
Windows Server 2008
Kopfzeile
WSManDisp.h
IDL
WSManDisp.idl
Bibliothek
WSManDisp.tlb
DLL
WSMAuto.dll

Siehe auch

Authentifizierung für Remoteverbindungen

WinRM-Skript-API

Informationen zur Windows-Remoteverwaltung

Verwenden der Windows-Remoteverwaltung

Skripting in der Windows-Remoteverwaltung

Abrufen von Daten vom lokalen Computer

Abrufen von Daten von einem Remotecomputer