...
The Request By Attribute process is comprised of the following parts: the request string, the requests attribute, the request processscript, the request task, the result string, the results attribute.
- The request string is a JSON string that contains the required properties and values for the request. A department administrator creates the JSON string manually or via a PowerShell script published by the Active Directory team.
- The requests attribute is a multi-valued attribute on a department's Administrative OU. A department administrator adds the request string to the requests attribute to submit the request. The attribute can contain multiple request strings.
- The request process script is the script a PowerShell that processes requests and the scheduled task that runs the script hourlyperforms the requested action. The request process script removes the request string from the requests attribute when processing the request.
- The request task is a scheduled task that start the request script every hour. The request task can be run manually by the Active Directory to expedite a request.
- The result string is a JSON string that contains the results of processing the request along with the original request string. The request process creates the result string and appends any errors encountered during processing to the result string.
- The results attribute is a multi-valued attribute on a department's Administrative OU. The request process adds the result string to the results attribute to report the outcome of the request to the department.
...
The Request By Attribute process leverages the requests attribute and results attribute on each department's Administrative OU object. The attributes are confidential and cannot be accessed by default. The request process and Active Directory team have been granted permissions
- The requests attribute for a department is the utexasEduAustinMulti1 attribute on the department's Administrative OU. The members of the department's Department Administrators group can read and write the attribute to submit or cancel requests for processing.
- The results attribute for a department is the utexasEduAustinMulti2 attribute on the department's Administrative OU. The members of the department's Department Administrators group can read the attribute to review the results of any processed requests.
...
The Active Directory team maintains a set of PowerShell scripts to assist department administrators with this process. The scripts are available at https://github.austin.utexas.edu/eis1-aad/Scripts in the Requests folder. The scripts below apply to all request types. See the pages for an individual request type for the scripts specific to that request type.
- Get-ADRequests.ps1 - displays any outstanding requests for a department
- Get-ADResults.ps1 - displays any completed requests for a department
- Show-ADRequestValues.ps1 - displays the properties and values supported by the process