The first four arguments are required and order dependent. -u is
required. All other arguments may or may not be required,
depending on what operation the tool is performing.
is one of O,M, I, A or N. This parameter controls
how duplicate records are handled.
O signals overwrite of any existing records that have
the same record name. All previous attribute values
are deleted.
M signals that the info from the import should be
merged into any existing record. This merge prefers
the new values, old values are kept only if no new
value is present. This option does not create a
record if one did not already exist.
I signals that any imported record should be ignored
if a record with the same name already exists.
A signals that data should be appended to fields
within existing records. This option does not cre-
ate a record if one did not already exist.
N signals that no duplicate checking should be done.
[-p pword] is the admin's password for import operations. Used
to authenticate to the directory node specified for
import. If not specified, a secure prompt will be
provided.
[-T ]
Used for delimited import of files that lack field
descriptions. These files must have fields in one
of the following orders:
xDSStandardUser contains the following fields in
the following order: RecordName Password UniqueID
PrimaryGroupID DistinguishedName NFSHomeDirectory
UserShell
xDSStandardGroup contains the following fields in
the following order: RecordName Password Primary-
GroupID GroupMembership
[-s ] Indicates the ID number to start with when the
import tool generates user IDs for for any import
file that lacks UID as part of the import data.
[-recordFormat ]
Passes in the delimiters and attributes and record
type to specify the order and names of attributes
in the file to be imported. An example record for-
mat string:
0x0A 0x5C 0x3A 0x2C dsRecTypeStandard:Users 7 dsAt-
trTypeStandard:RecordName dsAttrTypeStandard:Pass-
word dsAttrTypeStandard:UniqueID dsAttrTypeS-
tandard:PrimaryGroupID dsAttrTypeStandard:RealName
dsAttrTypeStandard:NFSHomeDirectory dsAttrTypeS-
tandard:UserShell
[-r ] is the group ID used for any records that do not
specify primary group ID.
[-v] signals verbose status output
[-d ] Passes the four delimiters ( end of record, escape,
end of field, and end of value, in that order) for
a delimited export. these values must be passed as
hex strings. example 0x16 (22 decimal)
[-y IP] Connects to a remote machine at the network address
specified for proxy DS access.
[-yrnm ] Specifies user name to use for the proxy connection
[-yrpwd ] Specifies password to use for the proxy connection.
For proxy connections name/password are required.
If -yrnm is specified, but not -yrpwd, then a
secure prompt will be specified.
[-n ]
Set which attribute (by index) is used for the
imported records' key for matching duplicate
records. This is used for delimited imports only.
If none specified, zero is assumed. recordKeyIndex
is a zero-based index which indicates which
attribute will be the recordKey.
[-userpreset ]
Designate a preset record to be applied to imported
user records.
[-grouppreset ]
Designate a preset record to be applied to imported
group records.
[-f ]
Force a specific value for the named attribute for
all records during the import. The new value will
overwrite any value specified in the import file.
Multiple values may be specified by using the value
delimeter between values. This option may be speci-
fied multiple times for multiple attributes.
[-V] Prints version number.
[-h] Outputs this usage text.
[-x] Don't import and erase delimited file after conver-
sion from XML. Helps debug XML.
EEXXAAMMPPLLEESS
To import a standard dsexport file into the Local database:
ddssiimmppoorrtt -g myimportFile /Local/Default I -u administrator -p
adminpassword
FILES /usr/bin/dsimport
~/Library/Logs/ImportExport
SEE ALSO
DirectoryService(1)
MacOSX December 21, 2019 MacOSX