Page History
...
Get-JS7AgentStatus [[-AgentId] <String>] [[-ControllerId] <String>] [-Coupled] [-DecoupledCouplingFailed] [-Reset] [-Resetting] [-Shutdown] [-CouplingFailedUnknown] [-EnabledNotHidden] [-Compact] [-Display] [<CommonParameters>]
...
Summary information is returned for 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
...
| Required? | false |
| Position? | 1 |
| Default value | |
| Accept pipeline input? | true (ByValue, ByPropertyName) |
| Accept wildcard characters? | false |
ControllerId
-ControllerId <String>
| Required? | false |
| Position? | 2 |
| Default value | |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
...
CouplingFailed
-Decoupled CouplingFailed <SwitchParameter>
Specifies to return information about Agents only that are decoupled from could not be successfully coupled with a Controller.
Typically this This indicates either an early stage before coupling occurs or an error 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
-CouplingFailed Resetting <SwitchParameter>
Specifies to return information about Agents only that could not be successfully coupled with a Controllerthat are in process of performing a reset.
During a reset operation the Agent drops its journal and restarts.
This indicates an error 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 |
Enabled
| ? | 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 -Enabled <SwitchParameter>
Specifies to return information about enabled visible Agents only.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
...
PS > Get-JS7AgentStatus -AgentId 'agent_001' -Display
Returns summary information about the Agent with ID "agent_001". Formatted output is displayed.
...
Overview
Content Tools