PowerCmd Protocol

The PowerCmd protocol is for the Windows discovery.

The PowerCmd protocol provides a generic Windows Shell based on PowerShell. It can be used to run Windows commands like the NTCMD protocol and Universal Discovery protocol. The PowerCmd protocol is a wrapper of PowerShell and only uses the PowerShell protocol.

Parameter

Description

Allow Redirection

Allows redirection of this connection to an alternate Uniform Resource Identifier (URI).

Default: false

Application Name The application name. This parameter must be set in case the remote application name is different from WSMan.
Connection Timeout

Time-out in milliseconds after which the Probe stops trying to connect to the destination machine.

Default: 30000

Connection URI

A fully qualified Connection URI.

Default: null

Port Number The port number. By default, a PowerShell agent uses port 5985 for a regular connection and 5986 for a secure connection. If you are using a different port for PowerShell in your environment, enter the required port number.
Use SSL

Uses the Secure Sockets Layer (SSL) protocol to establish a connection to the remote computer. By default, SSL is not used.

User Name

The name of the user that can connect to the remote machine by PowerShell.

User Password

The password of the user that can connect to the remote machine by PowerShell.

Windows Domain

The Windows domain on which the credentials are defined. If this field is empty, PowerShell assumes that the user is defined locally on the host.

Note This protocol supports IPv6.

Note When the CyberArk integration is enabled, two radio buttons (Regular Credential and External Vault) are enabled. The existing Username and Password parameters are grouped under the Regular Credential radio button, and CyberArk integration specific parameters Type and Reference are enabled and grouped under the External Vault radio button, as described in the table below.

CyberArk-related Parameters

Parameter

Description

Regular Credential

Enabled when CyberArk integration is enabled. Select this radio button to use regular credential as before.

  • Username. See description above.
  • Password. See description above.

External Vault

Enabled when CyberArk integration is enabled. Select this radio button to use an external credential vault.

  • Type. The external vault type. Currently only CyberArk is supported.
  • Reference. Click to open the Configure dialog box.

    • Reference. Select this option to configure the Reference ID that will be used by UCMDB/UD to retrieve the passwords from the CyberArk Enterprise Password Vault when they are needed.

      Set the reference ID in the CyberArk Enterprise Password Vault in the following format: <Safe Name>\<Folder Path>\<Reference ID>.

      Where <Safe Name> is the Safe value in CyberArk, <Folder Path> is the folder where the Safe belongs to, and <Reference ID> is the name of the CyberArk account you specified or auto-generated in CyberArk.

      For example, NancySafe\Root\nancy-cyberark-testing-refid.

    • Parameter. Select this option to enable configuring a list of editable CyberArk properties as a query string for UCMDB/UD to retrieve passwords from the CyberArk Enterprise Password Vault.

      To configure a CyberArk property value, click in the Value column for the property, and specify the value in string.

      The CyberArk properties values must not contain any of the following characters: \/:*?"<>|'.;

      The out-of-the-box list of CyberArk properties displayed in the Configure dialog box is editable. You can set selected CyberArk properties as the default list using JMX method setGlobalSettingVaule. For instructions, see "How to Set a Default List of CyberArk Properties Using JMX" in the Universal CMDB Data Flow Management section of the UCMDB Online Help.

      • Regex. Enables configuring CyberArk properties values in regular expressions.

        For examples of how to use regular expression syntax, see "Regular Expression Examples" in the Universal CMDB Modeling section of the UCMDB Online Help.

        The CyberArk properties values in regular expression must not contain any of the following characters: : ;