WSH - Objet WshNetwork

Décembre 2016

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
CollectionsPropriétésMé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 :

MéthodeDescription
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.
WshNetwork.RemoveNetworkDrive("J:";)
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.
WshNetwork.RemovePrinterConnection("LPT1:";)
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 WshNetwork

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

PropriétéDescription
ComputerNameContient une chaîne décrivant le nom de l'ordinateur.
UserDomainContient une chaîne décrivant le nom du domaine sur lequel l'ordinateur est connecté.
UserNameContient une chaîne décrivant le nom de l'utilisateur.

A voir également :

Ce document intitulé «  WSH - Objet WshNetwork  » issu de CommentCaMarche (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.