The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter contains the following sections:
Cisco UCS Director PowerShell Agent is a lightweight Microsoft Windows service application that acts as an interface layer between Cisco UCS Director and the Windows machine.
You can download a PowerShell Agent and install it on a Windows machine that has WinRM enabled. After you have started PowerShell Agent on a Windows machine, establish a connection between the PowerShell Agent and Cisco UCS Director. This connectivity enables you to execute PowerShell scripts to automate infrastructure configuration through Cisco UCS Director.
PowerShell Agent initiates a remote PowerShell session (PSSession) on the target server to run PowerShell commands. The target server is any Windows machine that is included in the WinRM configuration and that PowerShell Agent can access through the default WinRM port.
When a PowerShell command is executed through a Cisco UCS Director workflow task, the following occurs:
Cisco UCS Director sends the HTTP encoded command to PowerShell Agent.
PowerShell Agent establishes WSMAN connections to the remote machines and then executes the commands on them.
The output of the command is converted to XML and sent back to PowerShell Agent.
PowerShell Agent terminates the connection to the target server.
PowerShell Agent returns the output to Cisco UCS Director as the payload in HTTP response.
Other Cisco UCS Director workflow tasks can parse the returned PowerShell object information and use it as one or more variables.