Page History
...
Get-JS7AgentStatus
SYNOPSIS
Return Returns summary information from a JS7 Agent.for JS7 Agents assigned the current Controller
SYNTAX
Get-JS7AgentStatus [[-AgentId] <String>] [[-ControllerId] <String>] [-Coupled] [-CouplingFailed] [-Reset] [-Resetting] [-Shutdown] [-AgentsUnknown] <Uri [-NotHidden] >[-Compact] [-Display] [<CommonParameters>]
...
Summary information is returned from a JS7 Agentfor JS7 Agents that are assigned the current Controller.
* Summary information includes e.g. the start date and JS7 status of an Agent release.
This cmdlet can be used to check if an Agent is available.
The following REST Web Service API resources are used:
* /agents
PARAMETERS
AgentId
-AgentId <String>
Optionally specifies the unique identifier of an Agent for which informaiton is retrieved.
Without this parameter any Agents assigned the current Controller are returned.
| Required? | false |
| Position? | 1 |
| Default value | |
| Accept pipeline input? | true (ByValue, ByPropertyName) |
| Accept wildcard characters? | false |
ControllerId
-Agents <Uri[]>
Specifies an array of URLs that point to Agents. This is useful if specific Agents
should be checked. Without this parameter all Agents configured for a Controller will be checkedControllerId <String>
| Required? | false |
| Position? | 2 |
| Default value | |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
Coupled
-Coupled <SwitchParameter>
Specifies to return information about Agents only that are coupled with a Controller.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
CouplingFailed
-CouplingFailed <SwitchParameter>
Specifies to return information about Agents only that could not be successfully coupled with a Controller.
This indicates an error state.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
Reset
-Reset <SwitchParameter>
Specifies to return information about Agents that did perform a reset operation.
This indicates a volatile state that later on is replaced by a coupling state.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
Resetting
-Resetting <SwitchParameter>
Specifies to return information about Agents that are in process of performing a reset.
During a reset operation the Agent drops its journal and restarts.
This indicates a volatile state, that later on is replaced by a coupling state.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
Shutdown
-Shutdown <SwitchParameter>
Specifies to return information about Agents only that in process of shutting down.
This indicates that respective Agents are about to terminate.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
Unknown
-Unknown <SwitchParameter>
Specifies to return information about Agents only for which the status is unknown.
An unknown status indicates that no connection can be established to the respective Agent.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
NotHidden
-NotHidden <SwitchParameter>
Specifies to return information about visible Agents only.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
Compact
-Compact <SwitchParameter>
Specifies to return a smaller set of information items about Agents.
| Required? | false |
| Position? | 1named |
| Default value | False |
| Accept pipeline input? | true (ByValue, ByPropertyName)false |
| Accept wildcard characters? | false |
...
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
RELATED LINKS
EXAMPLES
-------------------------- EXAMPLE 1 --------------------------
PS > Get-JobSchedulerAgentStatus JS7AgentStatus -Display
Displays summary information about all JS7 Agents configured for the current Controller.
...
PS > Get-JS7AgentStatus -Agents http://localhost:4445 AgentId 'agent_001' -Display
Returns summary information about the Agent with ID "agent_001". Formatted output is displayed.
...
PS > $status = Get-JS7AgentStatus -Agents http://localhost:4445Decoupled -CouplingFailed
Returns summary information about Agents that currently are not coupled with a ControllerReturns a status information object.
Overview
Content Tools