Skip to content

Targets

Targets define the syslog destinations where PowerShell Orchestrator agents forward script execution output. Each target represents a syslog server or LT Auditor MP collector endpoint. Targets are configured centrally on the PowerShell Orchestrator Server and selected when creating jobs and schedules.

Understanding targets:

When a PowerShell script is executed by an agent, the script output is forwarded to the syslog target selected at job creation time. Configuring at least one target is required before jobs can be created.

Accessing the Targets page:

  1. Log in to the PowerShell Orchestrator Server web interface at https://<server-name>:52866
  2. Navigate to Targets in the main navigation

The Targets page displays all configured syslog destinations with their name, server address, port, and protocol.

Adding a new target:

  1. Click Add Target
  2. Fill in the target details:

Name: A descriptive name for the target:

Examples:

Production LT Auditor MP

Production Syslog

Development Environment

Syslog Server: The hostname or IP address of the destination server:

Example: ltauditor.company.com

Example: 192.168.1.100

Port: The syslog port on the destination server:

Default: 514

Protocol: Select the transport protocol:

Protocol Description Recommended Use
UDP Fast, no delivery guarantee Lower security requirement environments
TCP Reliable delivery Production environments — recommended
TLS Encrypted TCP Production environments with strict security requirements
  1. Click Save Target

Editing a target:

  1. Locate the target in the Targets list
  2. Click the Edit button next to the target
  3. Modify the settings as needed
  4. Click Save Changes

Changes to a target take effect on the next job that uses it. Jobs currently running will complete using the previous target configuration.

Deleting a target:

Confirm no active jobs or schedules are referencing a target before deleting it. Deleting a target referenced by an existing schedule may prevent that schedule from creating new jobs correctly.

  1. Locate the target in the Targets list
  2. Click the Delete button next to the target
  3. Confirm the deletion

Verifying target connectivity:

Before creating jobs confirm the PowerShell Orchestrator Server can reach the configured target:

On Windows:

Test-NetConnection -ComputerName <target-host> -Port <port>

A successful response confirms the port is open and reachable. If the connection fails review firewall rules between the PowerShell Orchestrator Server and the syslog destination.

Best practices:

  • Configure and verify at least one target before creating any jobs
  • Use TCP rather than UDP in production environments for reliable script output delivery
  • Use descriptive target names so the correct destination is easy to identify when creating jobs and schedules
  • Test target connectivity before placing jobs into production
  • Document each target’s host, port, and protocol so the configuration is auditable

[Your administrator should confirm the LT Auditor MP syslog listener port and protocol before creating the target, and ensure the LT Auditor MP transformation rule is configured to receive PowerShell Orchestrator forwarded events.]