Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Name

Set-JS7Agent

SYNOPSIS

Add an Stores a Standalone Agent to the JS7 Controller or modify Agent propertiesJOC Cockpit inventory

SYNTAX

Set-JS7Agent [-AgentId] <String> [-AgentName] <String> [-Url] <Uri> [[-AgentAlias] <String[]>] [[-ControllerId] <String>] [-WatchCluster] [-Disable] [-Hide] [[-AuditComment] <String>] [[-AuditTimeSpent] <Int32>] [[-AuditTicketLink] <Uri>] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

This cmdlet adds an stores a Standalone Agent to a JS7 Controller. A number of Agent properties can be modified.the JOC Cockpit inventory that later on can be deployed to a Controller.

Consider that the Agent identification specified with the -AgentId parameter cannot be modified
for the lifetime of an a Standalone Agent.

The following REST Web Service API resources are used:

* /agents/inventory/store

PARAMETERS

AgentId

-AgentId <String>
Specifies a unique identifier for an a Standalone Agent. This identifier cannot be modified during the lifetime of an Agent.
In order to modify the Agent identifier the Controller connected Agents have Standalone Agent has to be terminated and
journals have to be cleaned upremoved and added.

Required?true
Position?1
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-AgentName <String>
The name of an a Standalone Agent is used e.g. in job assignments of a workflow. During deployment the Agent Name
is replaced by the respective Agent ID for the Controller to which the workflow is deployed.

Should deployments of the same workflows be performed to a number of Controllers then for each Controller
the same Agent Name has to be configured (pointing to a different Agent ID).

...

-Url <Uri>
Specifies the URL for which the Standalone Agent is available. A URL includes the protocol (http, https), hostname and port
for which an Agent is operated.

Required?true
Position?3
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

AgentAlias

-AgentAlias <String[]>
Optionally specifies a number of alias names for a Standalone Agent that are separated by a comma.
An alias name is an alternative name for the same Agent that can be used when assigning Agents to jobs.

Required?false
Position?4
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

ControllerId

-ControllerId <String>
Specifies the identification of the Controller to which the Standalone Agent is dedicated.

Required?false
Position?5
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-WatchCluster <SwitchParameter>
A JS7 Controller cluster Cluster requires one Agent to be assigned the role of a cluster watcher.
Such an Agent will be considered if the JS7 Controller cluster Cluster decides about a fail-over situation with
no network connection being available between primary and secondary JS7 Controller instances.

...

-Disable <SwitchParameter>
An A Standalone Agent can be disabled to prevent further execution of jobs by the Agent. Orders for deployed workflows will
be put in a blocked state when processing a job that is assigned a disabled Standalone Agent.

Required?false
Position?named
Default valueFalse
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

Hide

-Hide <SwitchParameter>
A Standalone Agent can be hidden to prevent further use in workflow configurations. Deployed workflows still can
use a disabled Agenta hidden Agent.

In addition, a hidden Agent it not considered with the Agent Component Status and Agent Cluster Status widgets in the JS7 Dashboard.

Required?false
Position?named
Default valueFalse
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-AuditComment <String>
Specifies a free text that indicates the reason for the current intervention, e.g. "business requirement", "maintenance window" etc.

The Audit Comment is visible from the Audit Log view of the JOC Cockpit.
This parameter is not mandatory. However, however, the JOC Cockpit can be configured to enforce require Audit Log comments for any all interventions.

Required?false
Position?46
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-AuditTimeSpent <Int32>
Specifies the duration in minutes that the current intervention required.

This information is visible with shown in the Audit Log view. It can be useful when integrated
with a ticket system that logs the time spent on interventions with JobSchedulerJS7.

Required?false
Position?57
Default value0
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-AuditTicketLink <Uri>
Specifies a URL to a ticket system that keeps track of any interventions performed for JobSchedulerJS7.

This information is visible with shown in the Audit Log view of JOC Cockpit.
It can be useful when integrated with a ticket system that logs interventions with JobSchedulerJS7.

Required?false
Position?68
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

PS > Set-JS7Agent -AgentId 'agent_001' -AgentName 'primaryAgent' -Url https://agent-2-0-primary:4443 -WatchClusterControllerId 'testsuite'

Stores a Standalone Adds an Agent with the specified attributes to the given Controller.

-------------------------- EXAMPLE 2 --------------------------

PS > Set-JS7Agent -AgentId 'agent_002' -AgentName 'secondaryAgent' -Url https://agent-2-0-secondary:4443 -Disable -Hide

Stores a Standalone Agent that is disabled in its Controller and hidden from assignment to jobsAdds an Agent with the specified attributes.