Online Manual: "User Management Resource Adminstrator"
Go to: User Management Resource Administrator homepage
Script Action: Create Directory
Function
Create a directory on a (NTFS) file system. For the directory, you can
setup the permissions as well. Additionally, you can create a share for the directory.
Deployment
This action is typically used in a script that is intended to create
new users in Active Directory or NT4 domains, after creation of the actual
user account with Script Action:
Create User (AD) or Script
Action: Create User (no AD). This action is then used to create for
example the home directory and share for that user in the file system.
It can however also be used in any other context.
Properties
|
Property Name |
Description |
Typical setting |
Remarks |
|
Computer |
The computer name on which the directory is
created |
%HomeServer% |
See the Remarks section below. |
|
Parent path |
The relative path to the parent directory
of the new to be created directory |
users |
See the Remarks section below. The path has the form
<share name>\<subdir1>\...
Example: users\students\2004 |
|
Directory name |
The name of the directory to be created |
%UserName% |
See the Remarks section below. The directory will
be created as a sub-directory of the specified parent path. |
|
Always create unique directory |
Add a number to the directory name before
creating the directory, if a directory with the original name does already
exist. |
Yes |
|
|
Security |
Specifies the (NTFS) access rights on the
Directory |
Set by special dialog |
Specifies the access rights for different users on the directory. It
is possible to use variables to construct the names.
It is also possible to use a variable that contains the SID of a user
instead of a user name. When creating a user with the script action Create
User, the SID of the user is exported to the variable %UserSid% by default.
This variable can be used inside the dialog to refer to the just created
user. For more info see Directory
security - Overview.
|
|
Share the directory |
Specifies if the directory must be shared. |
No |
|
|
Share name |
The name by which the directory is shared. |
%UserName%
or
%UserName%$ |
In order to create a hidden share, specify
a $ as the last char of the name |
|
Share permissions |
The permissions of the share (!) of the new
directory. If this property is not specified, the default settings apply. |
|
If the permissions of the share are not specified,
the share permissions are set to full control for everyone. |
|
Share user limit |
Specifies the number of users who can connect
to the shared folder at one time. If this property is not specified, the
number is set to unlimited. |
|
If not specified, an unlimited number of user
connections is accepted. |
Remarks
A directory is always created in a parent
directory. The directory can
be created on a remote or the local computer. The
parent directory must be accessible in order to successfully create the
directory. Further, the user
running the application must have sufficient access rights for the parent
directory to create the directory and setup the share and permissions.
The parent directory has the following format (specified using property
names):
Computer\Parent
path
The field Computer specifies the name of the computer in NETBIOS
of DNS-style. The Parent path specifies the name of a share and eventually
a directory on the Computer. The table below shows some examples. In
this table the following columns are in shown:
Computer:
property of the action;
Parent path: property of the action:
Local path on specified computer:
The logical
drive path
of the resulting total path of the parent directory. This path is relative
to the specified computer.
Resulting total path of parent directory:
The target directory is created in this directory. Using this specification,
the parent path can be access from a remote computer.
Comments:
Description of this example entry.
|
Computer |
Parent path |
Local path on specified computer |
Resulting total path of parent directory |
Comments |
|
SERVER_A |
Users |
G:\Users |
\\SERVER_A\Users |
The directory G:\Users
is shared as Users on the computer. |
|
SERVER_A |
Users\Sales |
G:\Users\Sales |
\\SERVER_A\Users\Sales |
The directory G:\Users is shared as Users on the computer. The directory Sales
is a subdirectory of this directory. |
|
SERVER_A |
Sales |
G:\Users\Sales |
\\SERVER_A\Sales |
The directory G:\Users\Sales is shared as Sales on the computer. |
|
SERVER_A |
G$\Users |
G:\Users |
\\SERVER_A\G$\Users |
The local drive G:\
on the computer is shared as G$
(administrative share). The directory Users
is a subdirectory of logical drive G:\. |
More information:
Security - Overview
Principle of operation
Project operations - Input data
Project operations - Manage script actions
Project operations - Variables
Help on help
|