DOCUMENT:Q254808 13-MAY-2002 [iis] TITLE :IIS Sample ADSI Script to Create FTP Virtual Directories PRODUCT :Internet Information Server PROD/VER:winnt:5.0 OPER/SYS: KEYWORDS: ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - Microsoft Internet Information Services version 5.0 ------------------------------------------------------------------------------- SUMMARY ======= Microsoft Internet Information Services (IIS) version 5.0 includes several sample Windows Scripting Host (WSH) administration scripts in the %SystemDrive%\InetPub\AdminScripts folder. These sample scripts perform various administrative functions. This article gives a sample script to create FTP virtual directories to complement the existing set of scripts. MORE INFORMATION ================ Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support professionals can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs. If you have limited programming experience, you may want to contact a Microsoft Certified Partner or the Microsoft fee-based consulting line at (800) 936-5200. For more information about Microsoft Certified Partners, please visit the following Microsoft Web site: http://www.microsoft.com/partner/referral/ For more information about the support options that are available and about how to contact Microsoft, visit the following Microsoft Web site: http://support.microsoft.com/default.aspx?scid=fh;EN-US;CNTACTMS WSH Sample ADSI Script: 1. Save the following code as Mkftpdir.vbs in your %SystemDrive%\InetPub\AdminScripts folder: '------------------------------------------------------------ ' ' This is a simple script to create a new virtual FTP directory. ' ' Call this script with "-?" for usage instructions ' '------------------------------------------------------------ ' Force explicit declaration of all variables. Option Explicit On Error Resume Next Dim oArgs, ArgNum Dim ArgComputer, ArgFtpSites, ArgVirtualDirs, ArgDirNames(), ArgDirPaths(), DirIndex Dim ArgComputers Set oArgs = WScript.Arguments ArgComputers = Array("LocalHost") ArgNum = 0 While ArgNum < oArgs.Count If (ArgNum + 1) >= oArgs.Count Then Call DisplayUsage End If Select Case LCase(oArgs(ArgNum)) Case "--computer", "-c": ArgNum = ArgNum + 1 ArgComputers = Split(oArgs(ArgNum), ",", -1) Case "--ftpsite", "-f": ArgNum = ArgNum + 1 ArgFtpSites = oArgs(ArgNum) Case "--virtualdir", "-v": ArgNum = ArgNum + 1 ArgVirtualDirs = Split(oArgs(ArgNum), ",", -1) Case "--help", "-?" Call DisplayUsage End Select ArgNum = ArgNum + 1 Wend ArgNum = 0 DirIndex = 0 ReDim ArgDirNames((UBound(ArgVirtualDirs) + 1) \ 2) ReDim ArgDirPaths((UBound(ArgVirtualDirs) + 1) \ 2) If IsArray(ArgVirtualDirs) Then While ArgNum <= UBound(ArgVirtualDirs) ArgDirNames(DirIndex) = ArgVirtualDirs(ArgNum) If (ArgNum + 1) > UBound(ArgVirtualDirs) Then WScript.Echo "Error understanding virtual directories" Call DisplayUsage End If ArgNum = ArgNum + 1 ArgDirPaths(DirIndex) = ArgVirtualDirs(ArgNum) ArgNum = ArgNum + 1 DirIndex = DirIndex + 1 Wend End If If (ArgFtpSites = "") Or (IsArray(ArgDirNames) = False Or IsArray(ArgDirPaths) = False) Then Call DisplayUsage Else Dim compIndex For compIndex = 0 To UBound(ArgComputers) Call ASTCreateVirtualFtpDir(ArgComputers(compIndex), ArgFtpSites, ArgDirNames, ArgDirPaths) Next End If '------------------------------------------------------------ Sub Display(Msg) WScript.Echo Now & ". Error Code: " & Hex(Err) & " - " & Msg End Sub Sub Trace(Msg) WScript.Echo Now & " : " & Msg End Sub Sub DisplayUsage() WScript.Echo "Usage: mkftpdir [--computer|-c COMPUTER1,COMPUTER2]" WScript.Echo " <--ftpsite|-f FTPSITE1>" WScript.Echo " <--virtualdir|-v NAME1,PATH1,NAME2,PATH2,...>" WScript.Echo " [--help|-?]" WScript.Echo "" WScript.Echo "Note, FTPSITE is the Ftp Site on which the directory will be created." WScript.Echo "The name can be specified as one of the following, in the priority specified:" WScript.Echo " Server Number (i.e. 1, 2, 10, etc.)" WScript.Echo " Server Description (i.e ""My Server"")" WScript.Echo " Server Host name (i.e. ""ftp.domain.com"")" WScript.Echo " IP Address (i.e., 127.0.0.1)" WScript.Echo "" WScript.Echo "" WScript.Echo "Example : mkftpdir -c MyComputer -f ""Default Ftp Site""" WScript.Echo " -v ""dir1"",""c:\inetpub\ftproot\dir1"",""dir2"",""c:\inetpub\ftproot\dir2""" WScript.Quit End Sub '------------------------------------------------------------ Sub ASTCreateVirtualFtpDir(ComputerName, FtpSiteName, DirNames, DirPaths) Dim computer, ftpSite, FtpSiteID, vRoot, vDir, DirNum On Error Resume Next Set ftpSite = findFtp(ComputerName, FtpSiteName) If IsObject(ftpSite) Then Set vRoot = ftpSite.GetObject("IIsFtpVirtualDir", "Root") Trace "Accessing root for " & ftpSite.ADsPath If (Err <> 0) Then Display "Unable to access root for " & ftpSite.ADsPath Else DirNum = 0 If (IsArray(DirNames) = True) And (IsArray(DirPaths) = True) And (UBound(DirNames) = UBound(DirPaths)) Then While DirNum < UBound(DirNames) 'Create the new virtual directory Set vDir = vRoot.Create("IIsFtpVirtualDir", DirNames(DirNum)) If (Err <> 0) Then Display "Unable to create " & vRoot.ADsPath & "/" & DirNames(DirNum) & "." Else 'Set the new virtual directory path vDir.AccessRead = True vDir.Path = DirPaths(DirNum) If (Err <> 0) Then Display "Unable to bind path " & DirPaths(DirNum) & " to " & vRootName & "/" & DirNames(DirNum) & ". Path may be invalid." Else 'Save the changes vDir.SetInfo If (Err <> 0) Then Display "Unable to save configuration for " & vRootName & "/" & DirNames(DirNum) & "." Else Trace "Ftp virtual directory " & vRootName & "/" & DirNames(DirNum) & " created successfully." End If End If End If Err = 0 DirNum = DirNum + 1 Wend End If End If Else Display "Unable to find " & FtpSiteName & " on " & ComputerName End If Trace "Done." End Sub Function getBinding(bindstr) Dim one, two, ia, ip, hn one = InStr(bindstr, ":") two = InStr((one + 1), bindstr, ":") ia = Mid(bindstr, 1, (one - 1)) ip = Mid(bindstr, (one + 1), ((two - one) - 1)) hn = Mid(bindstr, (two + 1)) getBinding = Array(ia, ip, hn) End Function Function findFtp(computer, ftpname) On Error Resume Next Dim ftpsvc, site Dim ftpinfo Dim aBinding, binding Set ftpsvc = GetObject("IIS://" & computer & "/MsFtpSvc") If (Err <> 0) Then Exit Function End If ' First try to open the ftpname. Set site = ftpsvc.GetObject("IIsFtpServer", ftpname) If (Err = 0) And (Not IsNull(site)) Then If (site.Class = "IIsFtpServer") Then ' Here we found a site that is a ftp server. Set findFtp = site Exit Function End If End If Err.Clear For Each site In ftpsvc If site.Class = "IIsFtpServer" Then ' First, check to see if the ServerComment matches If site.ServerComment = ftpname Then Set findFtp = site Exit Function End If aBinding = site.ServerBindings If (IsArray(aBinding)) Then If aBinding(0) = "" Then binding = Null Else binding = getBinding(aBinding(0)) End If Else If aBinding = "" Then binding = Null Else binding = getBinding(aBinding) End If End If If IsArray(binding) Then If (binding(2) = ftpname) Or (binding(0) = ftpname) Then Set findFtp = site Exit Function End If End If End If Next End Function 2. Call this script with the following syntax for full usage instructions: CSCRIPT %SystemDrive%\InetPub\AdminScripts\MKFTPDIR.VBS -? For more information on Microsoft scripting technologies, see the following Web site: http://msdn.microsoft.com/scripting/ Additional query words: ====================================================================== Keywords : Technology : kbiisSearch kbiis500 Version : winnt:5.0 Issue type : kbhowto ============================================================================= THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY. Copyright Microsoft Corporation 2002.