Admin
The Admin section of the PowerShell Orchestrator Server provides user account management for the administrative web interface. This is where administrators create and manage user accounts, reset passwords, and control access to the PowerShell Orchestrator Server.
Accessing the Admin section:
- Log in to the PowerShell Orchestrator Server web interface at https://<server-name>:52866
- Navigate to Admin in the main navigation
User list overview:
The Admin page displays all configured administrator accounts with their username and email address.
Adding a new user:
- Click Add User
- Fill in the user details:
- Username — unique login name
- Email — the user’s email address
- Password — initial password must meet complexity requirements
- Assign the Administrator role
- Click Save
When a new user is created they are required to change their password on first login.
Password requirements:
| Requirement | Detail |
| Minimum length | 10 characters |
| Uppercase letters | At least one (A-Z) |
| Lowercase letters | At least one (a-z) |
| Digits | At least one (0-9) |
| Special characters | At least one special character |
Account security settings:
| Setting | Value |
| Failed login attempts before lockout | 5 |
| Lockout duration | 15 minutes |
| Session inactivity timeout | 60 minutes |
If a user account is locked after failed login attempts wait 15 minutes for the lockout to expire or have another administrator reset the account.
Changing your own password:
- Click your username in the top-right corner of the interface
- Select Change Password
- Enter:
- Current password
- New password
- Confirm new password
- Click Update Password
Forced password change:
All new user accounts are created with a forced password change flag enabled. On first login the user is automatically redirected to the Change Password page and must set a new password before accessing the dashboard.
Security best practices:
The following security practices are recommended for PowerShell Orchestrator Server administration:
- Change the default administrator password immediately after first login
- Use strong unique passwords for all accounts
- Replace the self-signed certificate with a CA-signed certificate in production
- Restrict server firewall rules to known agent IP addresses where possible
- Enable HMAC payload verification in high-security environments
- Regularly review job execution logs for unexpected activity
- Keep the server and agents updated to the latest versions
Communication security:
All communication between the server and agents uses HTTPS/TLS encryption. Additional security options available in the server configuration include:
| Feature | Description |
| HMAC Signature Verification | Verifies job payload integrity between server and agents — recommended for high-security environments |
| Certificate Pinning | Enhanced certificate validation for agent-to-server communication |
[Your administrator should review the appsettings.json configuration to enable HMAC signature verification and certificate pinning if required by your organization’s security policy.]
Script security:
PowerShell scripts are stored centrally on the server and downloaded to agents on demand at job execution time. Additional script security controls include:
| Feature | Description |
| Restricted PowerShell Sessions | Agents can execute scripts in restricted PowerShell sessions — configurable per deployment |
| Script Timeout Enforcement | Scripts that exceed the configured DefaultTimeoutSeconds value are terminated |
| Execution Logs | All script executions are logged and retained for audit trail purposes |
[Your administrator should confirm the appropriate PowerShell execution policy and timeout settings for your environment when configuring agent deployments.]