VBScript - Objet WshNetwork

WshNetwork

L'objet WshNetwork contient des informations sur le réseau Microsoft Windows, ainsi que des méthodes permettant de géer (connexion, déconnexion) des imprimantes et des partages réseau.

L'objet WshNetwork est obtenu en créant une instance de l'objet COM identifié par le progID «WScript.WshNetwork« :

Set WshNetwork = CreateObject("WScript.WshNetwork")

Voici un récapitulatif des propriétés et méthodes de l'objet WshNetwork :

Objet WshNetwork
Collections	Propriétés	Méthodes
	ComputerName UserDomain UserName	AddPrinterConnection EnumNetworkDrives EnumPrinterConnections MapNetworkDrive RemoveNetworkDrive RemovePrinterConnection SetDefaultPrinter

Méthodes de l'objet WshNetwork

Les méthodes de l'objet WshNetwork sont les suivantes :

WshNetwork.RemoveNetworkDrive("J:";)

WshNetwork.RemovePrinterConnection("LPT1:";)

Méthode	Description
AddPrinterConnection(strLocalName, strRemoteName [,bUpdateProfile] [,strUser] [,strPassword])	Permet de mapper une imprimante locale (strRemoteName) sur un nom de ressource locale (strLocalName). Lorsque l'argument facultatif bUpdateProfile vaut True, l'imprimante est stocké dans le profil de l'utilisateur. strUser et strPassword permettent de préciser optionnellement un utilisateur autre que celui du compte courant. WshNetwork.AddPrinterConnection("LPT1", "\\Serveur\Imprimante")
EnumNetworkDrives()	Renvoie une collection d'objets correspondant aux mappages de lecteurs de réseau du système.
EnumPrinterConnections()	Renvoie une collection d'objets correspondant aux mappages d'imprimantes réseau du système.
MapNetworkDrive(strLocalName, strRemoteName [,bUpdateProfile] [,strUser] [,strPassword])	Permet de mapper un partage réseau (strRemoteName) sur un nom de ressource locale (strLocalName). Lorsque l'argument facultatif bUpdateProfile vaut True, le lecteur de réseau est stocké dans le profil de l'utilisateur. strUser et strPassword permettent de préciser optionnellement un utilisateur autre que celui du compte courant. WshNetwork.MapNetworkDrive("J:", "\\Serveur\Partage")
RemoveNetworkDrive(strName[,bForce[,bUpdateProfile]])	Supprime la connexion réseau spécifiée par l'argument strName. L'argument facultatif bForce permet, lorsqu'il vaut True, de supprimer la connexion au lecteur réseau même s'il est en cours d'utilisation. Enfin, bUpdateProfile permet, lorsqu'il vaut True, de supprimer le lecteur du profil utilisateur.
RemovePrinterConnection(strName[,bForce[,bUpdateProfile]])	Supprime la connexion à l'imprimante spécifiée par l'argument strName. L'argument facultatif bForce permet, lorsqu'il vaut True, de supprimer la connexion à l'imprimante, même si elle est en cours d'utilisation. Enfin, bUpdateProfile permet, lorsqu'il vaut True, de supprimer l'imprimante du profil utilisateur.
SetDefaultPrinter(strPrinterName)	Définit l'imprimante distante spécifié en argument (strPrinterName) en tant qu'imprimante par défaut. WshNetwork.SetDefaultPrinter("\\Serveur\Imprimante")

Propriétés de l'objet WScript

Les propriétés de l'objet WshNetwork sont les suivantes :

Propriété	Description
ComputerName	Contient une chaîne décrivant le nom de l'ordinateur.
UserDomain	Contient une chaîne décrivant le nom du domaine sur lequel l'ordinateur est connecté.
UserName	Contient une chaîne décrivant le nom de l'utilisateur.

Ce document intitulé « VBScript - Objet WshNetwork » issu de l'encyclopédie informatique Comment Ça Marche (www.commentcamarche.net) est mis à disposition sous les termes de la licence Creative Commons. Vous pouvez copier, modifier des copies de cette page, dans les conditions fixées par la licence, tant que cette note apparaît clairement.