Computer Management Provider::Create Object

The Create Object method allows you to create a WinNT object on the designated server.

Input argument	Required	Description
Container	No	The full WinNT:// path of the object under which the new object should be created. For valid WinNT path specifications, see Definition of Terms for the Computer Management Provider API.
Class	No	The type of WinNT object to be created (that is, "user"). While this provider does not explicitly prevent the support for all valid WinNT object classes, specific support is provided for the following class types: User Group Service For a full list of all valid classes, see ADSI Objects of WinNT.
Name	Yes	The name for the new object to be created.
Properties	Yes	The collection of properties to set at the point that the object is created. Some objects require various properties to be set at the point that the object is created. For more information on required and optional properties for each class type, see WinNT Schema's Mandatory and Optional Properties.
Property	Yes	Node representing the property to set. @name: Display name for the property/
[value]	No	Node containing the value with which to update the property indicated by property/@name. The new value may also be provided as the inner text of the property node. In the case of a multivalued property with which you want to set multiple values, you must use the value nodes and should include one value node for each value you wish to assign.
[newPassword]	No	The password to use for a newly created user object. If class is set to "user" then this value is required; otherwise it is ignored.
[username]	No	The username to be used when connecting to the server. This parameter is the "key" parameter for using declarative authentication, meaning that if this value is present, the password and domain are then required. If this value is not present, values for the other two nodes will be ignored.
[password]	No	The password of the user connecting to the server. If username is provided, this value is required; otherwise it is ignored.
[domain]	No	The domain to use in conjunction with the username above. If username is provided, this value is required; otherwise it is ignored.

Note

Prior to creating the object, the provider will validate that any properties selected to be set are provided and valid for the object type to be created. If inconsistencies are found, or if any required properties are missing, an exception will be thrown.

Output argument

The Create Object method returns the WinNT-style path to the newly created object.

Remarks

Sample Code

Example XML Request

The following is an example of an XML request for the Create Object method of the Computer Management Provider:

<request>
		<procedure>
				<execute namespace="Computer Management Provider" procedure="Create Object">
				<executeData>
				<container>WinNT://Fabrikam/Web01,computer</container>
				<class>user</class>
				<name>SampleUser</name>
				<properties>
						<property name="FullName">Sample User</property>
						<property name="Description">
								<value>This is my sample user</value>
						</property>
				</properties>
				<newPassword>P@ssw0rd!</newPassword>
				</executeData> 			
				</execute>
		</procedure>
</request>

Example XML Response

The following is an example of an XML response for the Create Object method of the Computer Management Provider:

<response>
		<data>
				<path>WinNT://Fabrikam/Web01/SampleUser</path>
		</data>
</response>

Applies To