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 |
|
| Idl |
|
| Bibliothek |
|
| DLL |
|