Iisftp.vbs : script IIS de gestion de sites FTP
Mis à jour: janvier 2005
S'applique à: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2
Iisftp.vbs : script IIS de gestion de sites FTP
Crée, supprime et répertorie des sites FTP sur les serveurs locaux et distants qui exécutent Windows Server 2003 avec les services Internet (IIS) 6.0. Permet également de définir et d'extraire les propriétés d'isolation des utilisateurs, ainsi que de démarrer, d'arrêter et d'interrompre les sites FTP.
iisftp /create
Cette commande crée des sites FTP sur des serveurs locaux et distants.
Syntaxe
iisftp /create Chemin NomSite [/b Port] [/i AdresseIP] [/dontstart] [/isolation {ActiveDirectory | Local} [/domain NomDomaine /Admin [Domaine\]Utilisateur /AdminPwdMotDePasse]] [/s Ordinateur [/u [Domaine\]Utilisateur/p [MotDePasse]]]
Paramètres
- Chemin
- Obligatoire. Spécifie l'emplacement des fichiers de contenu du site FTP. Entrez un chemin vers un répertoire local, tel que C:\Projects\Docs. Si certains répertoires du chemin n'existent pas, Iisftp.vbs les crée. Le paramètre Chemin doit précéder immédiatement le paramètre NomSite. Autrement, Iisftp.vbs n'interprète pas correctement les informations relatives au site.
- NomSite
- Obligatoire. Spécifie un nom pour le site FTP.
- /b Port
- Spécifie un numéro de port TCP pour le site FTP. La valeur par défaut est 21.
- /i AdresseIP
- Spécifie une adresse IP pour le site FTP. La valeur par défaut est All Unassigned et elle affecte au site toutes les adresses IP de l'ordinateur qui ne sont pas affectées à d'autres sites. Un seul site de chaque serveur IIS peut prendre la valeur All Unassigned.
- /dontstart
- Indique que le site FTP ne démarre pas automatiquement dès sa création. Par défaut, IIS démarre le site FTP lorsque la commande /create s'est exécutée avec succès.
- /isolation {ActiveDirectory | Local}
- Indique un des deux modes d'isolation d'utilisateur, à savoir ActiveDirectory et Local. Si le commutateur /isolation est absent, le site n'utilise pas l'isolation.
- /domain NomDomaine
- Valide uniquement lorsque le commutateur /isolation est défini sur ActiveDirectory ; cette valeur représente le nom du domaine Active Directory.
- /Admin [Domaine\]Utilisateur
- Valide uniquement lorsque le commutateur /isolation est défini sur ActiveDirectory ; cette valeur représente le nom de l'administrateur au format Utilisateur, Domaine\Utilisateur ou Utilisateur@Domaine.
- /AdminPwd MotDePasse
- Valide uniquement lorsque le commutateur /isolation est défini sur ActiveDirectory ; cette valeur représente le mot de passe de l'administrateur.
- /s Ordinateur
- Exécute le script sur l'ordinateur distant spécifié. Tapez le nom ou l'adresse IP de l'ordinateur sans barre oblique inverse. Par défaut, le script s'exécute sur l'ordinateur local.
- /u [Domaine\]Utilisateur
- Permet d'exécuter le script avec les autorisations du compte d'utilisateur spécifié. Ce compte doit être membre du groupe Administrateurs sur l'ordinateur distant. Par défaut, le script s'exécute avec les autorisations de l'utilisateur courant de l'ordinateur local.
- /p Mot_De_Passe
- Spécifie le mot de passe du compte d'utilisateur désigné par le paramètre /u. Si vous n'indiquez pas ce paramètre, le script vous demande le mot de passe et les caractères saisis ne s'affichent pas à l'écran.
- /?
- Affiche l'aide dans l'invite de commandes.
Remarques
-
Pour suivre cette procédure, vous devez être membre du groupe Administrateurs sur l’ordinateur local, ou les autorisations nécessaires doivent vous avoir été déléguées. Si l’ordinateur est joint à un domaine, les membres du groupe Administrateurs du domaine doivent pouvoir suivre cette procédure. Les meilleures pratiques en matière de sécurité préconisent d’utiliser l’option Exécuter en tant que pour suivre cette procédure.
-
Iisftp.vbs ne vérifie ni le numéro de port, ni l'adresse IP d'un site FTP, pas plus qu'il ne vérifie que ces liens sont uniques dans le serveur. Si vous créez un site contenant des liens non valides ou conflictuels, le site ne démarre pas.
-
Lorsque vous utilisez Iisftp.vbs pour créer un nouveau site FTP, vous précisez uniquement les propriétés élémentaires requises pour créer le site et identifier son contenu. Iisftp.vbs utilise les mêmes propriétés par défaut que celles utilisées par IIS lors de l'établissement de nouveaux sites FTP et observe les mêmes règles pour l'héritage des propriétés. Pour configurer les propriétés plus avancées du site, utilisez le Gestionnaire des services Internet (IIS).
Exemples
Les exemples suivants illustrent l'utilisation de la commande iisftp /create dans différentes situations.
Pour créer un site FTP sur l'ordinateur local
La commande suivante crée un site FTP nommé Archive sur l'ordinateur local et l'associe au contenu du répertoire D:\Public\Archives. Cette commande ignore tous les paramètres facultatifs et accepte les valeurs par défaut. Le sous-répertoire Archives n'existe pas, mais Iisftp.vbs l'ajoute au répertoire Public.
iisftp /create D:\Public\Archives Archive
En réponse, Iisftp.vbs affiche un message de réussite ainsi que les propriétés de base du nouveau site FTP :
Connexion au serveur ...Terminé. Serveur = RESKIT Nom du site = Archive Chem. métabase = MSFTPSVC/1452008083 IP = Non assignée Port = 21 Racine = D:\Public\Archives État = STARTED
L'affichage montre que Iisftp.vbs a affecté les valeurs par défaut pour le site, notamment le numéro de port, l'adresse IP ALL UNASSIGNED et le démarrage automatique. Il a également ajouté un sous-répertoire Archives au répertoire D:\Public.
Remarquez que le chemin de métabase généré par IIS pour le nouveau site FTP est constitué de MSFTPSVC et d'un identificateur généré de façon aléatoire.
Pour créer un site FTP sur un ordinateur distant
La commande suivante crée le site FTP Drivers sur l'ordinateur distant Svr16 et l'associe aux fichiers du répertoire C:\Public\Download sur Svr16. La commande utilise le paramètre /i pour spécifier une adresse IP pour le site et le paramètre /dontstart pour empêcher IIS de démarrer le site automatiquement. Elle utilise également le paramètre /s pour identifier l'ordinateur distant et les paramètres /u et /p pour exécuter le script avec les autorisations attribuées au compte Administrateur de l'utilisateur.
iisftp /create C:\Public\Download Drivers /i 172.31.69.150 /dontstart /s Svr16 /u Admin6 /p p@ssWor##
En réponse, Iisftp.vbs affiche un message de réussite ainsi que les propriétés de base du nouveau site FTP :
Connexion au serveur ...Terminé. Serveur = SVR16 Nom du site = Drivers Chem. métabase = MSFTPSVC/1932955329 IP = 172.31.69.150 Port = 21 Racine = D:\Public\Download État = STOPPED
iisftp /delete, /start, /stop, /pause
Ces commandes suppriment, démarrent, arrêtent et interrompent des sites FTP sur des serveurs locaux et distants.
Syntaxe
iisftp[.vbs] {/delete | /start | /stop | /pause}SiteFTP [SiteFTP...][/sOrdinateur [/u [Domaine\]Utilisateur [/pMotDePasse]]]
Paramètres
- SiteFTP
- Obligatoire. Spécifie le nom du site ou le chemin d'accès de la métabase du site FTP. Au moins un site est requis. Les sites FTP doivent être identifiés de manière unique. Si plusieurs sites FTP présentent le même nom descriptif, vous devez utiliser le chemin d'accès de la métabase pour identifier le site FTP.
- /s Ordinateur
- Exécute le script sur l'ordinateur distant spécifié. Tapez le nom ou l'adresse IP de l'ordinateur sans barre oblique inverse. Par défaut, le script s'exécute sur l'ordinateur local.
- /u [Domaine\]Utilisateur
- Permet d'exécuter le script avec les autorisations du compte d'utilisateur spécifié. Ce compte doit être membre du groupe Administrateurs sur l'ordinateur distant. Par défaut, le script s'exécute avec les autorisations de l'utilisateur actuel de l'ordinateur local.
- /p Mot_De_Passe
- Spécifie le mot de passe du compte d'utilisateur désigné par le paramètre /u. Si vous n'indiquez pas ce paramètre, le script vous demande le mot de passe et les caractères saisis ne s'affichent pas à l'écran.
- /?
- Affiche l'aide dans l'invite de commandes.
Remarques
-
Pour suivre cette procédure, vous devez être membre du groupe Administrateurs sur l’ordinateur local, ou les autorisations nécessaires doivent vous avoir été déléguées. Si l’ordinateur est joint à un domaine, les membres du groupe Administrateurs du domaine doivent pouvoir suivre cette procédure. Les meilleures pratiques en matière de sécurité préconisent d’utiliser l’option Exécuter en tant que pour suivre cette procédure.
Exemples
Les exemples suivants illustrent l'utilisation de iisftp /delete, /start, /stop et /pause dans différentes situations.
Pour supprimer un site FTP
La commande suivante supprime le site FTP Downloads de l'ordinateur local :
iisftp /delete Downloads
En réponse, Iisftp.vbs affiche un message de réussite qui identifie le site FTP par son chemin d'accès dans la métabase, à savoir MSFTPSVC/1452008083 :
Le serveur MSFTPSVC/1452008083 a été supprimé.
Pour supprimer plusieurs sites FTP sur un ordinateur distant
La commande suivante supprime les sites Downloads, Drivers et Library de Svr01, un serveur distant. La commande identifie le site FTP Library d'après son chemin d'accès dans la métabase, à savoir MSFTPSVC/2109607139.
iisftp /delete Downloads Drivers MSFTPSVC/2109607139 /s Svr01
En réponse, Iisftp.vbs affiche un message de réussite qui identifie chaque site FTP par son chemin d'accès dans la métabase :
Le serveur MSFTPSVC/2109607139 a été supprimé. Le serveur MSFTPSVC/1879143292 a été supprimé. Le serveur MSFTPSVC/1932955329 a été supprimé.
Pour redémarrer un site FTP sur un ordinateur distant
Les commandes suivantes arrêtent, puis redémarrent le site FTP Drivers sur l'ordinateur distant Srv12. Les commandes identifient le site d'après son chemin d'accès dans la métabase, à savoir MSFTPSVC/1879143292. Les commandes utilisent le paramètre /s pour spécifier l'ordinateur distant. Dans cet exemple, les paramètres /u et /p sont omis, car l'utilisateur de l'ordinateur local est également administrateur de l'ordinateur distant.
iisftp /stop MSFTPSVC/1879143292 /s Srv12
iisftp /start MSFTPSVC/1879143292 /s Srv12
Pour interrompre, puis redémarrer un site FTP distant
Les commandes suivantes interrompent, puis redémarrent le site FTP Updates sur l'ordinateur distant Srv16. Les commandes utilisent le paramètre /s pour spécifier l'ordinateur distant et les paramètres /u et /p pour exécuter les commandes avec les autorisations attribuées au compte Administrateur de l'utilisateur.
iisftp /pause Updates /s Srv16 /u Adminx /p p@$$werd
iisftp /start Updates /s Srv16 /u Adminx /p p@$$werd
iisftp /setadprop
Cette commande définit les propriétés Active Directory d'un utilisateur spécifique sur un ordinateur local ou distant.
Syntaxe
iisftp[.vbs] /setadpropIDUtilisateur{FTPDir | FTPRoot}IDPropriété[/sOrdinateur [/u [Domaine\]Utilisateur [/pMotDePasse]]]
Paramètres
- IDUtilisateur
- Requis. Spécifie l'ID d'ouverture de session de l'utilisateur Active Directory.
- RépFTP|RacineFTP
- Obligatoire pour définir l'isolation de l'utilisateur. Spécifie l'isolation au niveau répertoire ou racine.
- IDPropriété
- Obligatoire pour définir l'isolation de l'utilisateur. Spécifie la valeur de l'isolation racine ou répertoire.
- /s Ordinateur
- Exécute le script sur l'ordinateur distant spécifié. Tapez le nom ou l'adresse IP de l'ordinateur sans barre oblique inverse. Par défaut, le script s'exécute sur l'ordinateur local.
- /u [Domaine\]Utilisateur
- Permet d'exécuter le script avec les autorisations du compte d'utilisateur spécifié. Ce compte doit être membre du groupe Administrateurs sur l'ordinateur distant. Par défaut, le script s'exécute avec les autorisations de l'utilisateur actuel de l'ordinateur local.
- /p Mot_De_Passe
- Spécifie le mot de passe du compte d'utilisateur désigné par le paramètre /u. Si vous n'indiquez pas ce paramètre, le script vous demande le mot de passe et les caractères saisis ne s'affichent pas à l'écran.
- /?
- Affiche l'aide dans l'invite de commandes.
Remarques
-
Pour suivre cette procédure, vous devez être membre du groupe Administrateurs sur l’ordinateur local, ou les autorisations nécessaires doivent vous avoir été déléguées. Si l’ordinateur est joint à un domaine, les membres du groupe Administrateurs du domaine doivent pouvoir suivre cette procédure. Les meilleures pratiques en matière de sécurité préconisent d’utiliser l’option Exécuter en tant que pour suivre cette procédure.
Exemples
L'exemple suivant définit les propriétés Active Directory de l'utilisateur MJones sur un ordinateur distant.
iisftp /SetADProp MJones FTPDir MikesDir /s Svr16 /u Admin6 /p p@ssWor##
Iisftp.vbs affiche un message « Connexion au serveur », suivi des propriétés Active Directory de MJones.
Connexion au serveur ...Terminé. Serveur = Svr16 Nom du site = MikesDir Chem. métabase = MSFTPSVC/1452004045 IP = Non assignée Port = 21 Racine = D:\Public\Archives IsoMode = FTPDir État = STARTED
Server représente le nom de l'ordinateur contenant le lecteur D: . Site Name est le nom que vous avez attribué au site FTP. Metabase Path représente la clé de métabase attribuée par IIS. IP n'est pas attribué par défaut. Port a la valeur 21 par défaut. Root est le répertoire contenant les fichiers FTP. IsoMode est défini sur FTPDir. Status a la valeur STARTED par défaut.
iisftp /getadprop
Cette commande obtient les propriétés Active Directory d'un utilisateur spécifique sur un ordinateur local ou distant.
Syntaxe
iisftp[.vbs] /getadpropIDUtilisateur[/sOrdinateur [/u [Domaine\]Utilisateur [/pMotDePasse]]]
Paramètres
- IDUtilisateur
- Requis. Spécifie l'ID d'ouverture de session de l'utilisateur Active Directory.
- /s Ordinateur
- Exécute le script sur l'ordinateur distant spécifié. Tapez le nom ou l'adresse IP de l'ordinateur sans barre oblique inverse. Par défaut, le script s'exécute sur l'ordinateur local.
- /u [Domaine\]Utilisateur
- Permet d'exécuter le script avec les autorisations du compte d'utilisateur spécifié. Ce compte doit être membre du groupe Administrateurs sur l'ordinateur distant. Par défaut, le script s'exécute avec les autorisations de l'utilisateur actuel de l'ordinateur local.
- /p Mot_De_Passe
- Spécifie le mot de passe du compte d'utilisateur désigné par le paramètre /u. Si vous n'indiquez pas ce paramètre, le script vous demande le mot de passe et les caractères saisis ne s'affichent pas à l'écran.
- /?
- Affiche l'aide dans l'invite de commandes.
Remarques
-
Pour suivre cette procédure, vous devez être membre du groupe Administrateurs sur l’ordinateur local, ou les autorisations nécessaires doivent vous avoir été déléguées. Si l’ordinateur est joint à un domaine, les membres du groupe Administrateurs du domaine doivent pouvoir suivre cette procédure. Les meilleures pratiques en matière de sécurité préconisent d’utiliser l’option Exécuter en tant que pour suivre cette procédure.
Exemples
L'exemple suivant renvoie les propriétés Active Directory de l'utilisateur BSmith sur l'ordinateur local.
iisftp /GetADProp BSmith
Iisftp.vbs affiche un message « Connexion au serveur », suivi des propriétés Active Directory de BSmith.
Connexion au serveur ...Terminé. Serveur = Svr16 Nom du site = Smittys Chem. métabase = MSFTPSVC/1452008083 IP = Non assignée Port = 21 Racine = D:\Public\Archives IsoMode = FTPRoot État = STARTED
Server représente le nom de l'ordinateur contenant le lecteur D: . Site Name est le nom que vous avez attribué au site FTP. Metabase Path représente la clé de métabase attribuée par IIS. IP n'est pas attribué par défaut. Port a la valeur 21 par défaut. Root est le répertoire contenant les fichiers FTP. IsoMode est défini sur FTPRoot. Status a la valeur STARTED par défaut.
iisftp /query
Cette commande affiche les sites FTP sur les serveurs locaux et distants.
Syntaxe
iisftp[.vbs] /query[SiteFTP [SiteFTP...]][/sOrdinateur [/u [Domaine\]Utilisateur [/pMotDePasse]]]
Paramètres
- SiteFTP
- Restreint la requête aux sites FTP spécifiés. Tapez le nom des sites FTP ou leur chemin d'accès dans la métabase. Par défaut, tous les sites FTP du serveur IIS sont affichés. Le site FTP doit être identifié de manière unique. Si plusieurs sites FTP présentent le même nom descriptif, vous devez utiliser le chemin d'accès de la métabase pour identifier le site FTP.
- /s Ordinateur
- Exécute le script sur l'ordinateur distant spécifié. Tapez le nom ou l'adresse IP de l'ordinateur sans barre oblique inverse. Par défaut, le script s'exécute sur l'ordinateur local.
- /u [Domaine\]Utilisateur
- Permet d'exécuter le script avec les autorisations du compte d'utilisateur spécifié. Ce compte doit être membre du groupe Administrateurs sur l'ordinateur distant. Par défaut, le script s'exécute avec les autorisations de l'utilisateur actuel de l'ordinateur local.
- /p Mot_De_Passe
- Spécifie le mot de passe du compte d'utilisateur désigné par le paramètre /u. Si vous n'indiquez pas ce paramètre, le script vous demande le mot de passe et les caractères saisis ne s'affichent pas à l'écran.
- /?
- Affiche l'aide dans l'invite de commandes.
Remarques
-
La sortie query inclut le nom du site, le chemin d'accès de la métabase et l'adresse IP (ou All pour désigner toutes les adresses non attribuées).
Exemples
Les exemples suivants illustrent l'utilisation de la commande iisftp /query dans différentes situations.
Pour interroger les sites FTP sur l'ordinateur local
La commande suivante affiche les sites FTP de l'ordinateur local :
iisftp /query
En réponse, Iisftp.vbs affiche tous les sites FTP IIS de l'ordinateur local :
Connexion au serveur ...Terminé. Nom du site (Chem. métabase) État IP Port ============================================================================== Site FTP par défaut (MSFTPSVC/1) STARTED Tout 21 Mon Site (MSFTPSVC/858812021) STOPPED Tout 21 Drivers (MSFTPSVC/1932955329) STARTED 172.30.163.249 21 Downloads (MSFTPSVC/1879143292) STARTED Tout 25 Library (MSFTPSVC/2109607139) STARTED 172.30.163.126 21
Pour interroger un site FTP spécifique sur un ordinateur distant
La commande suivante recherche le site FTP Downloads sur l'ordinateur distant Srv01 : Elle utilise le paramètre /s pour spécifier l'ordinateur distant et les paramètres /u et /p pour exécuter le script avec les autorisations attribuées au compte Administrateur de l'utilisateur.
iisftp /query Downloads /s Srv01 /u Admin6 /p A76QVJ32#
En réponse, Iisftp.vbs affiche le site FTP Downloads sur Srv01 :
Connexion au serveur ...Terminé. Nom du site (Chem. métabase) État IP Port ============================================================================= Downloads (MSFTPSVC/1879143292) STARTED Tout 21
Pour interroger plusieurs sites FTP
La commande suivante affiche l'état des sites FTP Downloads et Drivers sur l'ordinateur local : Elle utilise le nom des sites pour identifier les sites FTP, bien que les chemins d'accès dans la métabase soient également valides.
iisftp /query Downloads Drivers
En réponse, Iisftp.vbs affiche les sites FTP Downloads et Drivers :
Connexion au serveur ...Terminé. Nom du site (Chem. métabase) État IP Port ============================================================================= Drivers (MSFTPSVC/1932955329) STOPPED Tout 21 Downloads (MSFTPSVC/1879143292) STOPPED 171.16.1.120 21
Remarques
-
Pour suivre cette procédure, vous devez être membre du groupe Administrateurs sur l’ordinateur local, ou les autorisations nécessaires doivent vous avoir été déléguées. Si l’ordinateur est joint à un domaine, les membres du groupe Administrateurs du domaine doivent pouvoir suivre cette procédure. Les meilleures pratiques en matière de sécurité préconisent d’utiliser l’option Exécuter en tant que pour suivre cette procédure.
-
Iisftp.vbs exécute les mêmes opérations que celles qui sont disponibles à partir du Gestionnaire des services Internet (IIS). Vous pouvez utiliser l'un de ces outils pour administrer les sites FTP IIS.
-
L'ordinateur émettant la commande doit exécuter Windows XP ou un système d'exploitation de la famille Windows Server 2003. L'utilisateur doit être membre du groupe Administrateurs sur tout ordinateur concerné par la commande.
-
L'ordinateur concerné par la commande doit être un serveur exécutant Windows Server 2003 avec les services Internet (IIS) 6.0.
-
Iisftp.vbs affiche un message « Connexion au serveur » lors de la connexion au service IIS sur l'ordinateur spécifié. Ce message apparaît chaque fois que vous utilisez Iisftp.vbs, que ce soit sur un ordinateur local ou distant.
-
Iisftp.vbs affiche le message d'erreur « Le chemin d'accès spécifié est introuvable » lorsqu'il ne parvient pas à trouver le chemin d'accès vers un site FTP ou lorsque le service FTP n'est pas installé.
Légende de mise en forme
| Mise en forme | Signification |
|---|---|
|
Italique |
Informations que l'utilisateur doit fournir |
|
Gras |
Éléments que l'utilisateur doit taper tels qu'ils sont indiqués |
|
Points de suspension (...) |
Paramètre pouvant être répété plusieurs fois dans une ligne de commande |
|
Entre crochets ([]) |
Éléments facultatifs |
|
Entre accolades ({}), avec séparation des options par une barre verticale (|). Exemple : {pair|impair} |
Ensemble d'options parmi lesquelles l'utilisateur doit en choisir une seule |
|
|
Code ou données de programme |
Voir aussi
Concepts
Iisapp.vbs : script de requête d'application IISIisback.vbs : script de gestion de sauvegarde IIS
Iiscnfg.vbs : script de configuration IIS
Iisext.vbs : script d'extension de service Web IIS
IISFtpdr.vbs : script de répertoire FTP IIS
Iisvdir.vbs : script de répertoire virtuel IIS
Iisftp.vbs : script IIS de gestion de sites FTP
Liste alphabétique des commandes de ligne de commande
Vue d'ensemble de l'interface de commande
