Utilisation de Netsh
Netsh est un utilitaire d'exécution de scripts de ligne
de commande qui permet, localement ou à distance, d'afficher ou de
modifier la configuration réseau d'un ordinateur en fonctionnement.
Netsh fournit également une fonction de script qui permet
d'exécuter un ensemble de commandes en mode batch sur un ordinateur
spécifique. L'utilitaire Netsh peut également enregistrer un
script de configuration dans un fichier texte pour des besoins
d'archivage ou pour la configuration d'autres serveurs.
Contextes de Netsh
Netsh interagit avec d'autres composants du système
d'exploitation à l'aide de fichiers DLL. Chaque DLL d'application
d'assistance de Netsh fournit un vaste ensemble de fonctionnalités
portant le nom de contexte et regroupant des commandes spécifiques
à un composant de mise en réseau. Ces contextes accroissent les
fonctionnalités de netsh en permettant la prise en charge
d'un ou plusieurs services, utilitaires ou protocoles en matière de
configuration et de surveillance. Par exemple, Dhcpmon.dll fournit
à netsh le contexte et l'ensemble des commandes nécessaires
à la configuration et à la gestion des serveurs DHCP.
Pour exécuter une commande netsh, vous devez démarrer
netsh à partir de l'invite de commandes Cmd.exe et aller
dans le contexte qui contient la commande que vous voulez utiliser.
Les contextes auxquels vous avez accès dépendent des composants de
mise en réseau installés. Par exemple, si vous tapez dhcp à
l'invite de commandes Netsh, vous accédez au contexte DHCP, tandis
que le message suivant apparaît si DHCP n'est pas
installé :
La commande suivante n'a pas été trouvée :
dhcp.
Pour plus d'informations sur les contextes de Netsh, consultez
les rubriques suivantes :
Utilisation de contextes multiples
Un contexte peut contenir un autre contexte. Par exemple, à
l'intérieur du contexte Routage, vous pouvez passer du
sous-contexte IP au sous-contexte IPX.
Pour afficher la liste des sous-contextes et des commandes
susceptibles d'être utilisés dans un contexte, à l'invite de
commandes netsh, tapez le nom du contexte, suivi de
/? ou de help. Par exemple, pour afficher la liste
des sous-contextes et des commandes susceptibles d'être utilisés
dans le contexte Routage, à l'invite netsh (c'est-à-dire,
netsh>), tapez l'une des commandes suivantes :
routing /?
routing help
Pour effectuer des tâches dans un autre contexte sans changer le
contexte actuel, tapez le chemin d'accès du contexte de la commande
que vous voulez utilisez à l'invite de commandes netsh. Par
exemple, pour ajouter l'interface Connexion au réseau local dans le
contexte IGMP sans passer au contexte IGMP, à l'invite de commandes
netsh, tapez :
routing ip igmp add interface "Connexion au réseau local"
startupqueryinterval=21
Exécution de commandes Netsh à partir de l'invite de commandes
Cmd.exe
Lorsque vous exécutez Netsh à partir de l'invite de commandes
Cmd.exe, netsh utilise la syntaxe suivante. Pour exécuter
ces commandes Netsh sur un ordinateur distant fonctionnant sous
Windows 2000 Server, vous devez tout d'abord utiliser
Connexion au Bureau à distance pour vous connecter à un ordinateur
fonctionnant sous Windows 2000 Server qui exécute
Terminal Server. Des différences fonctionnelles peuvent apparaître
entre les commandes du contexte Netsh sur Windows 2000 et
Windows XP.
Pour afficher la syntaxe de la commande, cliquez sur la commande
suivante :
netsh
Netsh est un utilitaire d'exécution de scripts de ligne de
commande qui permet, localement ou à distance, d'afficher ou de
modifier la configuration réseau d'un ordinateur en fonctionnement.
Utilisée sans paramètres, la commande netsh ouvre l'invite
de commandes Netsh.exe (à savoir netsh>).
Syntaxe
netsh [-a FichierAlias]
[-c Contexte] [-r
OrdinateurDistant] [{CommandeNetsh|-f
FichierScript}]
Paramètres
- -a
- Revient à l'invite de commandes netsh après l'exécution
de FichierAlias.
- FichierAlias
- Indique le nom du fichier texte contenant une ou plusieurs
commandes netsh.
- -c
- Sélectionne le contexte netsh spécifié.
- Contexte
- Spécifie le contexte netsh. Le tableau suivant énumère
les contextes netsh disponibles.
| Contexte |
Description |
| AAAA
|
Affiche et définit la configuration de la base de données
d'authentification, d'autorisation, de gestion des comptes et
d'audit (AAAA) utilisée par IAS (Internet Authentication Service)
et le service de routage et d'accès à distance. |
| DHCP
|
Administre les serveurs DHCP et fournit une alternative
équivalente à la gestion par console. |
| Diag
|
Administre et résout les problèmes liés aux paramètres de
système d'exploitation et de service réseau. |
| Interface
|
Configure le protocole TCP/IP (notamment les adresses, les
passerelles par défaut, les serveurs DNS et les serveurs WINS) et
affiche des informations de configuration et des statistiques. |
| RAS
|
Administre les serveurs d'accès distant. |
| Routage
|
Administre les serveurs de routage. |
| WINS
|
Administre les serveurs WINS. |
- -r
- Configure un ordinateur distant.
- OrdinateurDistant
- Spécifie l'ordinateur distant à configurer.
- CommandeNetsh
- Spécifie la commande netsh à exécuter.
- -f
- Quitte Netsh.exe après l'exécution du script.
- FichierScript
- Spécifie le script à exécuter.
- /?
- Affiche de l'aide à l'invite de commandes.
Remarques
- Utilisation de -r
Si vous spécifiez -r suivi d'une autre commande,
netsh exécute la commande sur l'ordinateur distant puis
revient à l'invite de commandes Cmd.exe. Si vous spécifiez
-r sans autre commande, netsh s'ouvre en mode
distant. Ce processus est similaire à l'utilisation de set
machine à l'invite de commandes Netsh. Lorsque vous utilisez
-r, vous définissez l'ordinateur cible pour l'instance de
netsh en cours uniquement. Si vous quittez et démarrez à
nouveau netsh, l'ordinateur cible est réinitialisé à
l'ordinateur local. Vous pouvez exécuter des commandes netsh
sur un ordinateur distant en indiquant un nom d'ordinateur stocké
dans WINS, un nom UNC, un nom Internet que le serveur DNS peut
résoudre, ou une adresse IP numérique.
Exécution de commandes Netsh à partir de l'invite de commandes
Netsh.exe
Netsh utilise les commandes standard suivantes dans tous
les contextes exécutables à partir de l'invite de commandes
Netsh.exe (c'est-à-dire, netsh>). Pour exécuter ces commandes
Netsh sur un ordinateur distant fonctionnant sous
Windows 2000 Server, vous devez tout d'abord utiliser
Connexion au Bureau à distance pour vous connecter à un ordinateur
fonctionnant sous Windows 2000 Server qui exécute
Terminal Server. Des différences fonctionnelles peuvent apparaître
entre les commandes du contexte Netsh sur Windows 2000 et
Windows XP.
Pour afficher la syntaxe d'une commande, cliquez sur la
commande :
..
Se déplace vers le contexte situé à un niveau au-dessus.
Syntaxe
..
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
abort
Ignore les modifications apportées en mode hors connexion.
Abort n'a aucun effet en mode Connecté.
Syntaxe
abort
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
add
helper
Installe la DLL de l'application d'assistance dans
netsh.
Syntaxe
add helper NomDLL
Paramètres
- NomDLL
- Requis. Indique le nom de la DLL de l'application d'assistance
que vous voulez installer.
- /?
- Affiche de l'aide à l'invite de commandes.
alias
Ajoute un alias sous la forme d'une chaîne de caractères définie
par l'utilisateur, que netsh traite comme une autre chaîne
de caractères. Utilisée sans paramètres, la commande alias
affiche tous les alias disponibles.
Syntaxe
alias [NomAlias] [chaîne1
[chaîne2 ...]]
Paramètres
- alias [NomAlias]
- Affiche l'alias spécifié.
- alias
[NomAlias][chaîne1[chaîne2 ...]]
- Définit NomAlias à la (aux) chaîne(s) spécifiée(s).
- /?
- Affiche de l'aide à l'invite de commandes.
Exemples
L'exemple de script netsh suivant définit deux alias
netsh, Shaddr et Shp, puis quitte l'invite de commandes
Netsh dans le contexte Interface IP :
alias shaddr show interface ip addr
alias shp show helpers
interface ip
Si vous tapez shaddr à l'invite de commandes Netsh,
Netsh.exe interprète cette commande comme la commande show
interface ip addr. Si vous tapez shp à l'invite de
commandes Netsh, Netsh.exe interprète cette commande comme la
commande show helpers.
bye
Quitte Netsh.exe.
Syntaxe
bye
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
commit
Applique toutes les modifications apportées au routeur en mode
hors connexion. Commit n'a aucun effet en mode Connecté.
Syntaxe
commit
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
delete helper
Supprime la DLL de l'application d'assistance de
netsh.
Syntaxe
delete helper NomDLL
Paramètres
- NomDLL
- Requis. Indique le nom de la DLL de l'application d'assistance
que vous voulez désinstaller.
- /?
- Affiche de l'aide à l'invite de commandes.
dump
Crée un script contenant la configuration actuelle. Si vous
enregistrez ce script dans un fichier, vous pouvez utiliser
celui-ci pour rétablir les paramètres de configuration qui ont été
modifiés. Utilisée sans paramètres, la commande dump affiche
toutes les configurations du contexte netsh.
Syntaxe
dump [NomFichier]
Paramètres
- [NomFichier]
- Indique le nom du fichier vers lequel vous souhaitez rediriger
la sortie.
- /?
- Affiche de l'aide à l'invite de commandes.
exec
Charge un fichier de script et exécute des commandes à partir de
ce fichier.
Syntaxe
exec FichierScript
Paramètres
- FichierScript
- Requis. Indique le nom du script que vous voulez charger et
exécuter.
Remarques
- Le FichierScript peut s'exécuter sur un ou plusieurs
ordinateurs.
exit
Quitte Netsh.exe.
Syntaxe
exit
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
help
Affiche de l'aide.
Syntaxe
{/?|?|help|h}
Paramètres
- aucun
offline
Active le mode hors connexion.
Syntaxe
offline
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
Remarques
- Les modifications effectuées dans ce mode sont enregistrées,
mais vous devez exécuter la commande commit ou online
pour implémenter ces modifications dans le routeur.
- Lorsque vous passez du mode hors connexion au mode Connecté,
les modifications effectuées en mode hors connexion sont prises en
compte dans la configuration en cours d'exécution.
- Les modifications apportées en mode Connecté sont immédiatement
prises en compte dans la configuration en cours d'exécution.
online
Active le mode Connecté.
Syntaxe
online
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
Remarques
- Les modifications apportées en mode Connecté sont immédiatement
prises en compte dans la configuration en cours d'exécution.
- Lorsque vous passez du mode hors connexion au mode Connecté,
les modifications effectuées en mode hors connexion sont prises en
compte dans la configuration en cours d'exécution.
popd
Restaure un contexte de la pile.
Syntaxe
popd
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
Remarques
- Utilisée en conjonction avec pushd, la commande
popd permet de changer de contexte, d'exécuter la commande
dans le nouveau contexte puis de revenir au contexte
précédent.
Exemples
L'exemple de script suivant passe du contexte racine au contexte
interface ip, ajoute une route IP statique puis revient au
contexte racine :
netsh>pushd
netsh>interface ip
netsh interface ip>set address local static
10.0.0.9 255.0.0.0 10.0.0.1 1
netsh interface ip>popd
netsh>
pushd
Enregistre le contexte actuel dans une pile FILO
(first-in-last-out).
Syntaxe
pushd
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
Remarques
- Utilisée en conjonction avec popd, la commande
pushd permet de changer de contexte, d'exécuter la commande
dans le nouveau contexte puis de revenir au contexte
précédent.
quit
Quitte Netsh.exe.
Syntaxe
quit
Paramètres
- /?
- Affiche de l'aide à l'invite de commandes.
set file
Dirige la sortie de la fenêtre DOS vers un fichier.
Syntaxe
set file {open
NomFichier|append
NomFichier|close}
Paramètres
- open NomFichier
- Dirige la sortie de la fenêtre DOS vers le fichier
spécifié.
- append NomFichier
- Ajoute la sortie de la fenêtre DOS au fichier existant
spécifié.
- close
- Arrête l'envoi du contenu et ferme le fichier.
- /?
- Affiche de l'aide à l'invite de commandes.
Remarques
Exemples
Pour créer un nouveau fichier journal appelé Session.log et y
copier toutes les entrées et sorties ultérieures de netsh,
tapez :
set file open c:\session.log
set machine
Définit l'ordinateur actuel où effectuer les tâches de
configuration. Utilisée sans paramètres, la commande set
machine définit l'ordinateur local.
Syntaxe
set machine
[[NomOrdinateur=]chaîne]
Paramètres
- NomOrdinateur
- Spécifie le nom de l'ordinateur où effectuer les tâches de
configuration.
- chaîne
- Indique l'emplacement de l'ordinateur distant.
- /?
- Affiche de l'aide à l'invite de commandes.
Remarques
- Réalisation de tâches de configuration sur plusieurs
ordinateurs
Il est possible d'exécuter des commandes sur plusieurs
ordinateurs à partir d'un seul script. Vous pouvez utiliser la
commande set machine dans un script pour spécifier un
ordinateur de destination (par exemple, OrdinateurA), puis exécuter
les commandes qui suivent set machine sur cet ordinateur
(c'est-à-dire OrdinateurA). Vous pouvez ensuite utiliser set
machine pour spécifier un autre ordinateur de destination (par
exemple, OrdinateurB), puis exécuter des commandes sur cet
ordinateur (c'est-à-dire OrdinateurB).
set mode
Sélectionne le mode Connecté ou hors connexion comme mode en
cours.
Syntaxe
set mode {online|offline}
Paramètres
- online
- Active le mode Connecté.
- offline
- Active le mode hors connexion.
- /?
- Affiche de l'aide à l'invite de commandes.
show
Affiche des informations sur les alias, les applications
d'assistance et les modes.
Syntaxe
show
{alias|helper|mode}
Paramètres
- alias
- Affiche la liste de tous les alias définis.
- helper
- Affiche la liste de toutes les applications d'assistance de
niveau supérieur.
- mode
- Affiche le mode en cours.
- /?
- Affiche de l'aide à l'invite de commandes.
unalias
Supprime l'alias spécifié.
Syntaxe
unalias NomAlias
Paramètres
- NomAlias
- Requis. Spécifie le nom de l'alias.
- /?
- Affiche de l'aide à l'invite de commandes.
XOX
