CLI Reference > Server Administration Commands > im projects
im projects
displays the list of projects
im projects [--fields=field1[:width1],field2[:width2]...] [--fieldsDelim=value] [--height=value] [--width=value] [-x value] [-y value] [--user=name] [--hostname=server] [--password=password] [--port=number] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--[no]asAdmin] [--cwd=directory] [--forceConfirm=[yes|no]] [-g|--gui] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] project...
im projects displays a list of projects for workflows and documents. By default, all projects are selected to be displayed.
If you are a project administrator, only the projects that you are assigned to display, allowing you to specify, edit, and view only those projects. If you have additional permissions that allow you to view projects you are not assigned to, such as Admin or CreateProject, those projects also display.
This command takes the universal options available to allim commands, as well as some general options. See the options reference page for descriptions.
where fieldn can be any of the following:
displays the name of the project. By default, only the name is shown.
displays the database ID of the project. This is for PTC Technical Support only.
displays a description of the project.
displays if there is a parent that exists for the project.
displays the groups that have visibility or inheritance for the project.
displays the active status of the project.
displays if there is an image icon file used for an open project when it is displayed in the graphical user interface, and if the image is custom or default.
displays the users and groups who have been granted access to administer the project.
displays the backing issue ID for the project, if specified.
displays if there is an image icon file used for a closed project when it is displayed in the graphical user interface and if the image is custom or default.
displays a list of object references.
allows non-admin access to projects. This option is used for third party integrations using the Windchill RV&S API. The default setting is --asAdmin which requires ViewAdmin permissions. Specifying --noasAdmin allows users visability to permitted projects only. If a user selects a project without the applicable permissions they will receive an error indicating that the project was not found.
To learn more about the API, see your Windchill RV&S Integrations Builder Guide.
specifies the string to be used as a delimiter between fields displayed in the CLI.
specifies the names of the projects to view.
See Also
Commands: im createproject, im editproject, im viewproject, im deleteproject
Miscellaneous: options