Copyright: Copyright (c) 1998-2000 Adkins Resource, Inc.
Citation: Copyright (c) 1998-2000 Adkins Resource, Inc.


Contents

Overview

Command Syntax

Exporter Options

Output Formats

Registration and Licensing

Questions ?

What's Hyena ?


Registration and Licensing

The Exporter utility is free and does not require registration or payment for its use.  However, it is copyrighted under the laws of the United States, and has protections under US copyright law.  You may use the Exporter utility free of charge and distribute this utility to others in any form, including distribution in software libraries, as long as no profit is made from its distribution.  The license for the Exporter program is unlimited with respect to usage.

If you would like to be added to Adkins Resource's mailing list to receive notifications of changes to this utility and other products from us, you can submit a request to join our list to:

join-hyena@laser.sparklist.com,

This list is held in strict confidence by us, and will not be shared with anyone.  Historically, notifications are generally sent out each month.


Output Formats

The output file format for each type of object that the Exporter utility supports is listed below.  All output files are tab-delimited, for easy importing into Microsoft Excel or Access.

Users

Domain Name

Server Type

Server Name

User Name

Home Directory

Comment

Script Path

Full Name

User Comment

Profile

Home Directory Drive Letter

Logon To

Password Age

Password Life Remaining

Last Logon

Last Logoff

Account Expires

User Cannot Change Password

Password Never Expires

Account Disabled

Account Locked Out

Password Not Required

Password Expired (User Must Change Password at Next Logon)

RAS (dialup) setting (if ExportUserRAS setting enabled)

RAS (dialup) callback number (if ExportUserRAS setting enabled)

Primary Group

User Terminal Server Settings (if ExportUserTSE setting enabled)

Services

Domain Name

Server Type

Server Name

Service Name

Service Display Name

Service State

Service Type

Service Path to Executable

Service Start Type

Service Dependencies

Service Account Name

Groups

Domain Name

Server Type

Server Name

Group Type (local or global)

Group Name

Group Comment

Group Members

Domain Name

Server Type

Server Name

Group Type (local or global)

Group Name

User Name

User Domain (applicable only when user is from trusted domain)

Printers

Domain Name

Server Name

Printer Name

Share Name

Location

Comment

Port Name

Driver Name

Separator File

Print Processor

Data Type

Parameters

Machines (Computers)

Domain Name

Computer Type

Computer Name

Computer Comment

Computer Classification

Operating System Version

Computer Uptime (if option enabled)

HoxFixes (if option enabled)

Properties (if option enabled)

Disk Space

Domain Name

Computer Type

Computer Name

Drive Letter

Free Space

Total Space

Space Used

% of Drive Free

% of Drive Used

Format (mb, gb, bytes)

Drive Format (FAT, NTFS, etc)

Drive Volume Label

Drive Serial Number

Shares

Domain Name

Computer Type

Computer Name

Share Name

Share Path

Share Comment

Share Max Uses

Share Current Uses

User/Group Name

User/Group Access Rights


Overview

Background

The built-in utilities provided for management of Windows NT networks are generally adequate for managing relatively simple networks with a limited number of users.  However, as larger organizations begin to implement NT-based networks, management and administration of users, groups, shared resources, printers, and the various local vs. centralized elements of Windows NT can quickly maximize all available support resources.

In March of 1997, Adkins Resource, Inc. released a product named "Hyena" for managing Windows NT networks.  Since that time, Hyena has been a very popular utility for thousands of NT administrators worldwide to assist in the administration of large, multiple-domain NT networks.  Since its original release, Hyena included built-in exporting functions for users, groups, group memberships, computers, printers, service information, and more.  However, the exporting functions were part of Hyena's graphical interface, and therefore could not be used in a batch, unattended, or scheduled environment.  A frequent request from Hyena users was to make the export functions into a separate utility, one that could be executed from the command prompt and not require any user/window interaction.

Licensing and Distribution

A standalone version of Hyena's exporting functions is now being offered as a free utility.  You may use and distribute this utility free of charge.  Updates will be made available at www.adkins-resource.com.  Adkins Resource, Inc. retains all rights to this utility, and retains the right to charge a fee for use of future versions of this product.

Operation and Usage

The Exporter utility requires Windows NT 3.51 or later or Windows 2000. It will not run on Windows 95/98/Me.  There are not any .DLL requirements.  The only file required to run Exporter is the Exporter.EXE file and a settings file (.INI file).

The Exporter utility supports exporting of any combination of users, groups, group members, printers, computers, disk drives, and services on the network.  Options are available to target domain controllers, servers, workstations, or individual computers.  All output is written to delimited text files (the tab character is the default field delimiter), which can then be imported into any standard spreadsheet or database.  See the Syntax topic for how to run the Export program, and the Options topic for how to configure Exporter's Settings file.  For a list of fields that are written to the output files, see the Output Format section.

Hyena continues to be one of the most powerful system administration utilities available for management of Windows NT and Windows 2000 systems.  A free 30-day evaluation of Hyena can be downloaded from http://www.adkins-resource.  For more information about Hyena's capabilities, click here.


Questions and Support

All questions, inquiries, suggestions, or problems with the Exporter utility should be sent to support@systemtools.com.

Adkins Resource, Inc. can also be reached by mail, phone, and fax at the following addresses:

Adkins Resource, Inc.

P.O. Box 839

La Vernia, TX 78121

Phone: (830) 779-7008

Fax: (830) 779-2191

The Adkins Resource web site is located at http://www.adkins-resource.com. Updates to Hyena and the Exporter utility is available at this location.


What is Hyena?

Hyena is a Windows NT system administration tool that dramatically simplifies the day-to-day administrative functions of managing NT-based networks.  Designed to run only on NT-based computers, Hyena gives a hierarchical view of your NT network, and makes every network object easily accessible.  A sample screen capture is show below, showing how easily a multi-domain environment can be managed using Hyena's tree and list windows.

Hyena makes extensive use of Windows "tree" and "list" views to show domain objects in a logical manner. The tree structure graphically shows each object (for example users and groups), and gives the administrator control over what elements are displayed at any time. The list window shows detailed object information, while providing sorting and object property access. The list window also allows selecting single and multiple objects, which provides the capability to carry out the same task on several objects at the same time.  Similar to Windows Explorer, Hyena brings point-and-click simplicity to managing most Windows resources.

Hyena Functions and Features

All of Hyena's functions are available through keyboard commands, toolbar icons, or by clicking with the right mouse button to access popup context menus.  The list below itemizes the various objects that Hyena can manage and the supported functions for each of these objects.

Domains

Adding new domains to view window

Removing domains from view window

Send message to all domain users

Synchronizing all domain controllers

Servers and Computers

Viewing of online and offline (optional) computers

View single computer

Modify comment/description

Add new computer to domain

Remove computer from domain

View and modify account and audit policies

View and modify user rights

View shares and files

View and disconnect sessions and open files

View and modify services

View events

View processes

View scheduled jobs

Viewing all used and available disk space on all disk drives

Shutdown and (optionally) reboot

Send message

Users

Viewing all users

Viewing single user

Modifying single and multiple user properties

All user properties supported, included dialup (RAS)

Find buttons for login script and profiles

Edit login script using Notepad or any user-defined editor

Explore option for user home directory

Access user home directory share properties, and create user home share

Add new user

Copy existing user

Rename user

Send message to user

Delete single or multiple users

Manage user Exchange mailbox settings

Modify user Terminal Server settings

Groups

Viewing all groups (global and local)

Viewing single group

Adding new group

Viewing group members

Modifying properties and membership

Rename group

Copy group

Delete groups

Shares

View all shares on any server or workstation (including hidden)

View single share

View connections

Stop sharing

Modify properties and permissions

View all shares access permissions for entire server

Create new share

View files and directories

Integration with Windows Explorer ®

Connect network drive (local workstation)

Files and Directories

Viewing of all files and directory contents on any share

Properties, including security, auditing, and ownership

View all file security information for selected files/directories

Copy, moving, deleting files

Rename files

Print and open

Create new files

"Open With…" dialog support

Printers

Control printer queue (pause, purge all jobs, resume printing, etc.)

Cancel and view print jobs

View all printers on any server or workstation

View printer setup dialog

Connect to printers (local workstation)

Remove printer connections (local workstation)

Services and Drivers

View all services and drivers on any server or workstation

Change service state - stop, start, pause

View service dependencies

Change service state on multiple computers at the same time

Delete service (not supported by all services)

Change service startup information

Change service startup information on multiple computers at the same time

Open Files

View all open files on any server or workstation

Disconnect (close) open files

Sessions

View all user sessions on any workstation or server

Disconnect sessions

Send messages to users

Events

View events from one or more workstations/servers using built-in viewer, including filtering and searching for specific event(s)

View events (through Event Viewer) on any workstation or server

Exporting / Copying Information

Export users, groups, group members, computers, services, and printer definitions to tab-delimited text files for all server or workstations in any domain.

Copy information displayed in list window to clipboard or text file

Miscellaneous

Schedule jobs (uses NT's built-in AT scheduler) for one or more computers

Print the contents of any portion of the list window

Configure user-defined tools and command line options

Generate text output file using macro facility from anything displayed in list window.

Using Hyena with the Exporter utility

Hyena is not required to run the export utility, but it does provide a graphical front-end for running Exporter.  As such, it will automatically create/modify a Export.INI file for you.

To run the Exporter utility using Hyena, click Hyena's first toolbar button to display the export property sheet.  Select a domain to export, and configure the remaining settings as desired.  Hyena will execute the selected "Export command", which by default simply runs the Exporter.exe program.  Note that the settings from this dialog are saved into a file named "Export.INI" by default.  Use of Hyena is independent of the Exporter program.


Command Syntax

The command-line syntax for running the Exporter program is:

Exporter [.INI Settings File] [Domain Name] [Computer Name]

Each of these three command parameters is optional.  However, Exporter does require that a Settings file (.INI file) be configured prior to use.  This file is then used by the Exporter program to determine which objects to export.  Unless a specific Settings file is specified for the first command line argument, Exporter will attempt to find and use a file named Export.INI in the current directory.  This file is supplied with the Exporter program, and MUST be modified prior to using the Exporter program for the first time.  For a complete list of the options available in the Settings file, review the Options topic. For a list of fields that are written to the output files, see the Output Format section.

Optional Command-Line Arguments

[.INI Settings File] - The default settings file is named Export.INI; this file is supplied with the Exporter program.  For more information on the format and options of this file, review the Options topic.

Note: Windows will normally look for all .INI files in the <Windows> directory.  To force the Exporter program to look for a custom Settings file in the current directory, prepend ".\" to the name of the settings file.  For example, if the settings file is named "Europe.INI", use the command: "Exporter .\Europe.INI" if the Europe.INI file resides in the current directory.  If you are using the default file name of "Export.INI", you do not need to enter anything on the command line.

[Domain Name] - Use this option to override the domain name specified in the Settings file.  Note that you must also specify a Settings File when using this option.  If targeting a specific computer, the domain name can be set to anything, but must be specified.

[Computer Name] - Use this option to force the Exporter program to only export a single computer's objects.  The information entered for the Domain Name is not used, but is written to the output files; therefore, the computer does not have to be a domain member.


Exporter Options

The contents of the sample Export.INI file that is distributed with the Exporter program is reproduced below.  Prior to using the Exporter program for the first time, the ExportDomain setting in this file must be modified.  In addition, one or more of the settings will need to be modified to configure which domain objects to export.  As originally distributed, the Export.INI is configured to export all of the domain users only to a file named "Users.TXT" on drive C:.

The next sections outline the configuration of each of the areas in the Exporter Settings file. The majority of the settings are On/Off settings; a value of "0" (zero) indicates that the setting is turned OFF, a value of "1" indicates that it is ON.  Do not enter quotes around any of the settings (see the sample .INI file below for specific syntax requirements). For a list of fields that are written to the output files, see the Output Format section.

General

ExportTitles - Set to "1" to export field titles into the output files, or "0" to not export field titles.

Verbose - Set to "1" to display progress information, or "0" for quiet operation.

VeryVerbose - Set to "1" to display more progress and debugging information.

ExportDomain - The name of the domain to use for the export.

ExportCmd - This settings is used by Hyena only.

Delimiter - Use this option to change the default delimiter (the TAB character).

Append - Set to "1" to specify that all output files should be appended to, rather than overwritten.  If the files do not exist, they will be automatically created.  Normally, the output files should be deleted first before running Exporter with the Append option set.

SkipUnix = Set to “1” to skip computers running Unix (Samba and Linux SMB servers)

Users

ExportUsers -Set to "1" to export users, or "0" to not export user accounts.  If enabled, one or more of the options below must also be enabled.

ExportUserFile - Used to specify the name of the user export file.

ExportDomainUsers - Set to "1" to export domain (PDC) users

ExportBDCUsers - Set to "1" to export users from all BDCs in the domain.

ExportServerUsers - Set to "1" to export users from all servers in the domain.

ExportWorkstationUsers - Set to "1" to export all workstation users in the domain.  Enabling the verbose option is recommended when exporting workstation users due to the time that will be required for the export.

ExportUserRAS - Set to "1" to export user RAS (dialup) configuration.  Note: Workstation or server running the exporter utility must either be configured for RAS, or have the RASSAPI.DLL file.

ExportUserTSE – Set to “1” to export user Terminal Server information.  Note: To use this feature, run the Exporter utility on the Terminal Server itself, or copy the following files from the Terminal Server to the system32 directory of the computer running Exporter:

wtsapi32.dll

utildll.dll

winsta.dll

regapi.dll

Services

ExportServices - Set to "1" to export services, or "0" to not export services.  If enabled, one or more of the options below must also be enabled.

ExportServiceFile - Used to specify the name of the services export file.

ExportServerServices - Set to "1" to export services on all servers in the domain.

ExportWorkstationServices - Set to "1" to export services on all workstations in the domain.

ExportSpecificServices - Set to the name of specific services and/or drivers to export.  This setting is case sensitive !  Enclose the name of the service(s) in square brackets "[]".  For example, to only export the settings for the Scheduler and UPS services, use:

ExportSpecificServices=[Scheduler][UPS]

Groups

ExportGroups - Set to "1" to export groups, or "0" to not export groups.  If enabled, one or more of the options below must also be enabled.

ExportGroupFile - Used to specify the name of the group export file.

ExportDomainGlobalGroups - Set to "1" to export domain (PDC) global groups.

ExportDomainLocalGroups -  Set to "1" to export domain (PDC) local groups.

ExportServerLocalGroups - Set to "1" to export server local groups.

ExportWorkstationLocalGroups - Set to "1" to export workstation local groups.

ExportSpecificGroups - Set to the name of specific groups and/or group members to export.  This setting is case sensitive !  Enclose the name of the group(s) in square brackets "[]".  For example, to only export the settings for the Administrator and Domain Admins groups, use:

ExportSpecificGroups=[Administrator][Domain Admins]

Note: This setting is used by both the Groups and Group Members export

Group Members

ExportMembers - Set to "1" to export group members, or "0" to not export group members.  If enabled, one or more of the options below must also be enabled.

ExportMemberFile - Used to specify the name of the group members export file.

ExportDomainGlobalMembers - Set to "1" to export domain (PDC) global group members.

ExportDomainLocalMembers - Set to "1" to export domain (PDc) local group members.

ExportServerLocalMembers - Set to "1" to export server local group members.

ExportWorkstationLocalMembers - Set to "1" to export workstation local group members.

Printers

ExportPrinters - Set to "1" to export printers, or "0" to not export printers.  If enabled, one or more of the options below must also be enabled.

ExportPrinterFile - Used to specify the name of the printer export file.

ExportServerPrinters - Set to "1" to export all server printers.

ExportWorkstationPrinters - Set to "1" to export all workstation printers.

Machines (Computers)

ExportMachines - Set to "1" to export computer accounts, or "0" to not export computer accounts.  If enabled, one or more of the options below must also be enabled.

ExportMachineFile - Used to specify the name of the computer export file.

ExportServerMachines - Set to "1" to export all servers on the domain.

ExportWorkstationMachines - Set to "1" to export all workstations on the domain.

ExportComputerUptime - Set to "1" to export to computer uptime information.

ExportComputerProperties – Set to “1” to export computer properties.

Disk Space

ExportDrives – Set to “1” to export disk space information, or “0” to not export disk space information.

ExportServerDrives – Set to “1” to export disk space information for servers

ExportWorkstationDrives – Set to “1” to export disk space information for workstations.

ExportDriveFile – Used to specify the name of the disk space export file.

ExportDriveFormat – Set to “0” to export disk space in bytes, “1” to use mb, or “2” to use gb.

ExportDriveSpaceMask – Set to the “mask” used to access a unique share name for each drive for retrieval of disk space information; this share does NOT have to be at the root of the drive.  The default mask is “%s$”, where %s becomes replaced with the drive letter for each drive, ie C$, D$, etc.  The mask must contain the replaceholder %s which is replaced by the drive letter.  For example, “drive-%s” could be used if a share exists for each drive named “drive-C”, “drive-D”, etc.

Shares

ExportShares – Set to “1” to export share information, or “0” to not export share information

ExportShareFile – Used to specify the name of the share export file.

ExportServerShares – Set to “1” to export share information for servers.

ExportWorkstationShares – Set to “1” to export share information on workstations

ExportShareSecurity – Set to “1” to export user/group and access permission information on share security.

Sample Export.INI File

The following information is contained in a file named Export.INI that is distributed with the Exporter program.  To use the default file as-is, you must modify the ExportDomain option below, and configure any desired export options as outlined above.  As configured below, only domain users will be exported.

[Export]

Verbose=1

VeryVerbose=0

ExportDomain=put your domain name here

ExportTitles=1

Append=1

SkipUnix=1

ExportCmd=.\exporter.exe

Delimiter=

ExportUsers=1

ExportUserFile=c:\users.txt

ExportDomainUsers=1

ExportBDCUsers=0

ExportServerUsers=0

ExportWorkstationUsers=0

ExportUserRAS=0

ExportUserTSE=0

ExportGroups=0

ExportGroupFile=

ExportDomainGlobalGroups=0

ExportDomainLocalGroups=0

ExportServerLocalGroups=0

ExportWorkstationLocalGroups=0

ExportSpecificGroups=

ExportPrinters=0

ExportPrinterFile=

ExportServerPrinters=0

ExportWorkstationPrinters=0

ExportServices=0

ExportServiceFile=

ExportServerServices=0

ExportWorkstationServices=0

ExportSpecificServices=

ExportMembers=0

ExportMemberFile=

ExportDomainGlobalMembers=0

ExportDomainLocalMembers=0

ExportServerLocalMembers=0

ExportWorkstationLocalMembers=0

ExportMachines=1

ExportMachineFile=c:\machines.txt

ExportServerMachines=1

ExportWorkstationMachines=0

ExportComputerUptime=0

ExportComputerProperties=0

ExportDrives=0

ExportServerDrives=1

ExportWorkstationDrives=0

ExportDriveFile=c:\drives.txt

// use:

// 0=bytes

// 1=mb

// 2=gb

ExportDriveFormat=2

ExportDriveSpaceMask=""

ExportShares=0

ExportShareFile=c:\shares.txt

ExportServerShares=1

ExportWorkstationShares=0

ExportShareSecurity=1