CLI Reference > Server Administration Commands > im createproject
 
im createproject
creates a project
Synopsis
im createproject [--name=value] [--parent=project] [--description=value] [--permittedAdministrators=u=user1,user2,...;g=group1,group2] [--permittedGroups=group,group,...] [--[no]inheritPermittedGroups] [--openImage=[none|default|<path>] [--closedImage=[none|default|<path>] [--[no]active] [--user=name] [--hostname=server] [--password=password] [--port=number] [(-?|--usage)] [(-N|--no)] [(-Y|--yes)] [(-Ffile|--selectionFile=file)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [-g|--gui] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]]
Description
im createproject creates a project for workflows and documents. For example:
im createproject --name=SavingsManager --inheritPermittedGroups --parent=/FinancialToolkit
creates the /FinancialToolkit/SavingsManager project, inheriting the permitted groups from the parent project FinancialToolkit.
Options
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
--name=value
specifies the name of the project to create. Names can be a maximum of 100 characters and cannot contain a forward slash (/) or square brackets. This option is mandatory.
--parent=project
specifies the name of the parent project. If specified, then the new project becomes subproject of the parent project. The specified parent project must exist before creating a subproject. When specifying a parent project, you must include a forward slash and the full project name, for example, /AuroraProject.
--description=value
specifies a description of the project.
--permittedAdministrators=u=user1,user2,...;g=group1,group2,...
Specifies a comma delimited list of users and/or groups that can administer this project. Project Administrators are allowed to edit and view projects. Project Administrators can also manage all child projects of the project they are approved for, but they cannot edit projects assigned to another Project Administrator. Project Administrators can only create and delete subprojects, they cannot create top level projects unless they have been granted the CreateProject ACL permission. Project Administrators can view all users, groups, and dynamic groups. They can also edit dynamic group membership for projects they are assigned to. If not specified, the project creator is the assigned Administrator. For more information, see the Integrity Lifecycle Manager Help Center.
--permittedGroups=group,group,...
specifies a comma delimited list of groups that have visibility for this project.
--[no]inheritPermittedGroups
controls whether or not permissions are inherited from the parent project. Project settings cannot be inherited unless there is a parent project. Inherited permissions are mutually exclusive with --permittedGroups.
--openImage=[none|default|<path>]
specifies whether an image appears for an open project.
--image=none does not specify an image for the project.
--image=default specifies the default "open" image for the project.
--image=<path> specifies the path and name of a custom image for the project, for example, c:\images\project_icon.gif.
* 
Images must be GIF or JPEG format, and no larger than 16 by 24 pixels.
--closedImage=[none|default|<path>]
specifies file path for an image icon file used for a closed project when displayed in the graphical user interface. See--openImage for details. The default image is a closed folder.
--[no]active
Specifies if the project is actively used in Integrity Lifecycle Manager. This option is useful for removing inactive projects in your organization. Specifying --noactive prevents the project from being displayed in project drop-down lists; however, the project still appears in existing issue data.
See Also
Commands: im editproject, im viewproject, im deleteproject, im projects
Miscellaneous: options