WSH - 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 :
| 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.
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 |
|---|---|
| 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. |