DOCUMENT:Q148128 09-AUG-2001 [winnt] TITLE :Using MACFILE to Administer Services for Macintosh PRODUCT :Microsoft Windows NT PROD/VER::2000,3.51,4.0 OPER/SYS: KEYWORDS:kbnetwork ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - Microsoft Windows NT Server versions 3.51, 4.0 - Microsoft Windows 2000 Server - Microsoft Windows 2000 Advanced Server ------------------------------------------------------------------------------- SUMMARY ======= Microsoft Windows NT Server 3.51, Windows 2000 Server and Windows Advanced Server include a command line tool that can manage the Services for Macintosh server configuration called MACFILE. MACFILE allows administrators to automate Services for Macintosh volume, directory, file, and server management in batch programs. This article lists and describes the parameters you can use with the MACFILE command. For additional information on the MACFILE command, type the following at the command prompt: macfile /? For a complete reference to the MACFILE command, select Help from the MacFile menu in File Manager. MORE INFORMATION ================ MACFILE consists of four commands. They are the following: - Volume - Directory - Server - Forkize Macfile Volume -------------- This adds, changes or removes Macintosh-accessible volumes. The syntax is as follows: macfile volume {/add | /set}[/server:\\computername] /name:volumename /path:directory [/readonly:[true | false]] [/guestsallowed:[true | false]][/password:password][/maxusers:number | unlimited] macfile volume /remove [/server:\\computername] /name:volumename Parameters Description ---------- ----------- /add Adds a volume using the specified settings. /set Changes a volume using the specified settings. /server:\\computername Specifies the server on which to add, change or remove a volume. If omitted, the operation is performed on the local computer. /name:volumename Specifies the volume name to be added, changed, or removed. This parameter is required. /path:directory Specifies the path to the root directory of the volume to be created. Valid and required only when adding a volume. /readonly:[true|false] Specifies users cannot change files in the volume. Use true or false to change the current setting of the volume. If omitted when adding a volume, changes to files are allowed. If omitted when changing a volume,the readonly setting for the volume remains unchanged. /guestsallowed: Specifies whether users logging on as guests can [true|false] use the volume. If omitted when adding a volume, guests can use the volume. If omitted when changing a volume, the guestsallowed setting for the volume remains unchanged. /password:password Specifies a password required to access the volume. If omitted, no password is created. If omitted when changing a volume, the password remains unchanged. /maxusers:number| Specifies the maximum number of users that can unlimited simultaneously use files on the volume. If omitted when adding a volume, an unlimited number of users can use the volume. If omitted when changing a volume, the maxusers value remains unchanged. /remove Removes the specified volume. Macfile Directory ----------------- This modifies directories in Macintosh-accessible volumes. The syntax is as follows: macfile directory [/server:\\computername] /path:directory [/owner:ownername] [/group:groupname][/permissions:permissions] Parameters Description ---------- ----------- /server:\\computername Specifies the server on which to change a directory. If omitted, the operation is performed on the local computer. /path:directory Specifies the path to the directory to be changed on the Macintosh-accessible volume. The directory must exist; Macfile directory does not create directories. This parameter is required. /owner:ownername Changes the owner of the directory. If omitted, the owner remains unchanged. /group:groupname] Specifies or changes the Macintosh primary group associated with the directory. If omitted, the primary group remains unchanged. /permissions: Sets permissions on the directory for the owner, permissions primary group, and world (everyone). An eleven digit number is used to set permissions. The number 1 grants permission; 0 revokes permission. For example, 11111011000. The position of the digit determines which permission is set, as described in the following table. If omitted, permissions remain unchanged. Position Sets Permisson for: First OwnerSeeFiles Second OwnerSeeFolders Third OwnerMakeChanges Fourth GroupSeeFiles Fifth GroupSeeFolders Sixth GroupMakeChanges Seventh WorldSeeFiles Eighth WorldSeeFolders Ninth WorldMakeChanges Tenth The directory cannot be renamed, moved, or deleted. Eleventh The changes apply to the current directory and all subdirectories. Macfile Server -------------- This changes the Services for Macintosh server configuration. The sytax is as follows: macfile server [/server:\\computername] [/maxsessions:number | unlimited][/loginmessage:message][/guestsallowed:[true | false]] Parameters Description ---------- ----------- /server:\\computername Specifies the server on which to change parameters. If omitted, the operation is performed on the local computer. /maxsessions:[number| Specifies the maximum number of users that can unlimited] simultaneously use Services for Macintosh services. If omitted, the maxsessions setting for the server remains unchanged. /loginmessage:message Changes the message Macintosh users will see when logging on to the Services for Macintosh server. To remove an existing login message, include the /loginmessage parameter, but leave the message variable blank. If omitted, the loginmessage message for the server remains unchanged from the previous setting. The maximum number of characters for the login message is 199. /guestsallowed:[true| Specifies whether users logging on as guests can use Services for Macintosh services. If omitted, the guestsallowed setting for the server remains unchanged. Macfile Forkize --------------- This joins the data fork and resource fork of a Macintosh file into one file. Macfile forkize also changes the type or creator of the file. The syntax is as follows: macfile forkize [/server:\\computername] [/creator:creatorname] [/type:typename][/datafork:filepath] [/resourcefork:filepath] /targetfile:filepath Parameters Description ---------- ----------- /server:\\computername Specifies the server on which to join files. If omitted, the operation is performed on the local computer. /creator:creatorname Specifies the creator of the file. The creator parameter is use by the Macintosh Finder to determine the application that created the file. /type:typename Specifies the type of file. The file type is used by the Macintosh Finder to determine the file type within the application that created the file. /datafork:filepath Specifies the location of the data fork that is to be joined. You can specify a remote path. /resourcefork:filepath Specifies the location of the resource fork that is to be joined. You can specify a remote path. /targetfile:filepath Specifies the location of the file created by joining a data fork and a resource fork or specifies the location of the file whose type or creator you are changing. The file must be on the specified server. Additional query words: prodnt ====================================================================== Keywords : kbnetwork Technology : kbWinNTsearch kbWinNT351search kbWinNT400search kbwin2000AdvServ kbwin2000AdvServSearch kbwin2000Serv kbWinNTSsearch kbWinNTS400search kbWinNTS400 kbWinNTS351 kbwin2000ServSearch kbwin2000Search kbWinNTS351search kbWinAdvServSearch Version : :2000,3.51,4.0 ============================================================================= 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 2001.