Update User
Applies To: System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator, System Center 2012 SP1 - Orchestrator
You can use the Update User activity in a runbook to update the properties of a user in the Microsoft Active Directory.
This activity publishes all of the data from the required and optional properties into published data. Additional published data is generated based on the class that you select when you define the activity.
The following tables list the required and optional properties and published data for this activity.
Required properties for Update User activity
Element |
Description |
Valid Values |
Distinguished Name |
Relative distinguished name that uniquely identifies the user account |
String |
Optional properties for Update User activity
Element |
Description |
Valid Values |
Account Expires |
Date that the account expires |
DateTime |
Account Never Expires |
Specifies that the account never expires |
Boolean |
City |
User's city |
String |
Company |
User's company name |
String |
Department |
User's department name in their company |
String |
Description |
Description of the user |
String |
Display Name |
Displays the name for the user |
String |
Fax Number |
User's fax number |
String |
First Name |
User's first name |
String |
Home Directory |
The Home directory for the user account |
String |
Home Drive |
Specifies the drive letter to which the UNC path specified by homeDirectory will be mapped |
String |
Home Phone |
User's home telephone number |
String |
Initials |
Initials of the user's name |
String |
Last Name |
User's last name |
String |
Email addresses for the user |
String |
|
Manager |
Distinguished name of the account for the user's manager |
String |
Mobile Phone |
User's mobile telephone number |
String |
Pager |
User's pager telephone number |
String |
Password Never Expires |
Specifies that the user's password never expires |
Boolean |
Notes |
General notes about the user's telephone |
String |
Office |
User's office location |
String |
Post Office Box |
User's post office box number |
String |
Postal Code |
User's postal code or zip code |
String |
Profile Path |
Path to the location for the user's profile |
String |
Logon Script |
Path and name of the logon script for the account |
String |
State or Province |
User's state or province |
String |
Street Address |
User's street address |
String |
Phone Number |
User's telephone number |
String |
RDS Allow Logon |
Specifies whether the user is allowed to log on to Remote Desktop Services |
Boolean |
RDS Broken Connection Action |
Specifies the action to take when a Remote Desktop Services session limit is reached |
Boolean |
RDS Connect Client Drives |
Specifies whether to reconnect to mapped client drives when user logs on to a Remote Desktop Services session |
Boolean |
RDS Connect Printer Drives |
Specifies whether to reconnect to mapped client printers when user logs on to a Remote Desktop Services session |
Boolean |
RDS Default To Main Printer |
Specifies whether to print automatically to the client's default printer from a Remote Desktop Services session |
Boolean |
RDS Home Directory |
The Home directory for the user when they log on to Remote Desktop Services |
String |
RDS Home Drive |
The Home drive for the user when they log on to Remote Desktop Services |
String |
RDS Initial Program |
Path and file names of the application to start automatically when the user logs on to the Remote Desktop Services |
String |
RDS Max Connection Time |
Maximum duration, in minutes, of a Remote Desktop Session for the user |
Int32 |
RDS Max Disconnection Time |
Maximum amount of time, in minutes, that a disconnected Remote Desktop Services session remains active for the user |
Int32 |
RDS Max Idle Time |
Maximum amount of time, in minutes, that a Remote Desktop Services session can remain idle for the user |
Int32 |
RDS Profile Path |
Roaming or mandatory profile path to use when the user logs on to Remote Desktop Services |
String |
RDS Reconnection Action |
Specifies whether the user is allowed to reconnect to a disconnected Remote Desktop Services session |
Boolean |
RDS Remote Control |
Specifies whether to allow remote observation or remote control of the user's Remote Desktop Services session |
Int32 |
RDS Work Directory |
The working directory path for the user in a Remote Desktop Session |
String |
Title |
User's job title |
String |
User Cannot Change Password |
Specifies that the user cannot change their password |
Boolean |
User Must Change Password |
Specifies that the user must change their password the next time they log on. |
Boolean |
User Principal Name |
This attribute contains the UPN that is an Internet-style login name for a user based on the Internet standard RFC 822 |
String |
Web Page |
User's primary web page |
String |
Published data for Update User activity
Name |
Description |
Value Type |
Account Expires |
Date that the account expires |
DateTime |
Account Never Expires |
Specifies that account never expires |
Boolean |
City |
User's city |
String |
Company |
User's company name |
String |
Department |
User's department name in their company |
String |
Description |
Description of the user |
String |
Display Name |
Displays the name for the user |
String |
Distinguished Name |
Relative distinguished name that uniquely identifies the user account |
String |
Fax Number |
User's fax number |
String |
First Name |
User's first name |
String |
Home Directory |
The Home directory for the user account |
String |
Home Drive |
Specifies the drive letter to which to map the UNC path specified by homeDirectory |
String |
Home Phone |
User's home telephone number |
String |
Initials |
Initials of the user's name |
String |
Last Name |
User's last name |
String |
Email addresses for the user |
String |
|
Manager |
Distinguished name of the account for the user's manager |
String |
Mobile Phone |
User's mobile telephone number |
String |
Pager |
User's pager telephone number |
String |
Password Never Expires |
Specifies that the user's password never expires |
Boolean |
Notes |
General notes about the user's telephone |
String |
Office |
User's office location |
String |
Post Office Box |
User's post office box number |
String |
Postal Code |
User's postal code or zip code |
String |
Profile Path |
Path to the location for the user's profile |
String |
Logon Script |
Path and name of the logon script for the account |
String |
State or Province |
User's state or province |
String |
Street Address |
User's street address |
String |
Phone Number |
User's telephone number |
String |
RDS Allow Logon |
Specifies whether the user is allowed to log on to Remote Desktop Services |
Boolean |
RDS Broken Connection Action |
Specifies the action to take when a Remote Desktop Services session limit is reached |
Boolean |
RDS Connect Client Drives |
Specifies whether to reconnect to mapped client drives when user logs on to a Remote Desktop Services session |
Boolean |
RDS Connect Printer Drives |
Specifies whether to reconnect to mapped client printers when user logs on to a Remote Desktop Services session |
Boolean |
RDS Default To Main Printer |
Specifies whether to print automatically to the client's default printer from a Remote Desktop Services session |
Boolean |
RDS Home Directory |
The Home directory for the user when they log on to Remote Desktop Services |
String |
RDS Home Drive |
The Home drive for the user when they log on to Remote Desktop Services |
String |
RDS Initial Program |
Path and file names of the application to start automatically when the user logs on to the Remote Desktop Services |
String |
RDS Max Connection Time |
Maximum duration, in minutes, of a Remote Desktop Session for the user |
Int32 |
RDS Max Disconnection Time |
Maximum amount of time, in minutes, that a disconnected Remote Desktop Services session remains active for the user |
Int32 |
RDS Max Idle Time |
Maximum amount of time, in minutes, that a Remote Desktop Services session can remain idle for the user |
Int32 |
RDS Profile Path |
Roaming or mandatory profile path to use when the user logs on to Remote Desktop Services |
String |
RDS Reconnection Action |
Specifies whether the user is allowed to reconnect to a disconnected Remote Desktop Services session |
Boolean |
RDS Remote Control |
Specifies whether to allow remote observation or remote control of the user's Remote Desktop Services session |
Int32 |
RDS Work Directory |
The working directory path for the user in a Remote Desktop Session |
String |
Title |
User's job title |
String |
User Cannot Change Password |
Specifies that the user cannot change their password |
Boolean |
User Must Change Password |
Specifies that the user must change their password the next time they log on. |
Boolean |
User Principal Name |
This attribute contains the UPN that is an Internet-style login name for a user based on the Internet standard RFC 822 |
String |
Web Page |
User's primary web page |
String |
See Also
Concepts
Active Directory Activities
Active Directory Integration Pack for System Center 2012 - Orchestrator