...
Return summary information and statistics information from a JobScheduler Agent.
...
Get-JobSchedulerAgentStatus [[-Url] <Uri>] [[-Agents] <Uri[]>] [[-Path] <String>] [[-Timeout] <Int32>] [-Display] [-NoOutputs] [<CommonParameters>]
DESCRIPTION
Summary information and statistics information is are returned from a JobScheduler Agent.
* Summary information includes e.g. the start date and JobScheduler Agent release.
* Statistics information includes e.g. the number of running tasks.
This cmdlet can be used to check if an Agent is available.
PARAMETERS
Url
-Url <Uri>
Specifies the URL to access the Agent.
This parameter cannot be specified if the -Agents parameter is used.
| Required? | false |
| Position? | 1 |
| Default value | |
| Accept pipeline input? | true (ByValue, ByPropertyName) |
| Accept wildcard characters? | false |
Agents
-Agents <Uri[]>
Specifies an array of URLs that point to Agents. This is useful if specific a number of Agents
should be checked . Without this parameter all Agents configured for a Master will be checkedat the same time, e.g. should the Agents from the result of the
Get-JobSchedulerAgentCluster cmdlet be checked.
This parameter cannot be specified if the -Url parameter is used.
| Required? | false |
| Position? | 12 |
| Default value | |
| Accept pipeline input? | true (ByValue, ByPropertyName) |
| Accept wildcard characters? | false |
Path
-Path <String>
Specifies the URL path that is used to retrieve the Agent status.
Default: /jobscheduler/agent/api/overview
| Required? | false |
| Position? | 3 |
| Default value | /jobscheduler/agent/api/overview |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
Timeout
-Timeout <Int32>
Specifies the number of milliseconds for establishing a connection to the JobScheduler Agent.
With the timeout being exceeded the Agent is considered being unavailable.
Default: 3000 ms
| Required? | false |
| Position? | 4 |
| Default value | 3000 |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
...
-Display <SwitchParameter>
Optionally specifies formatted output to be displayed.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
NoOutputs
-NoOutputs <SwitchParameter>
Optionally specifies that no output is returned by this cmdlet.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
...
PS > Get-JobSchedulerAgentStatus -Displayhttp://localhost:4455
Returns Displays summary information about all JobScheduler Agents configured for the current Masterthe JobScheduler Agent.
-------------------------- EXAMPLE 2 --------------------------
PS > Get-JobSchedulerAgentStatus -Agents Url http://localhost:4445 4455 -Display
Returns summary information about the Agent. Formatted output is displayed.
...
PS > $status = Get-JobSchedulerAgentStatus -Agents http://localhost:44454455
Returns a status information object.
-------------------------- EXAMPLE 4 --------------------------
PS > $status = GetJobScheduler-AgentCluster /agent/fixed_priority_scheduling_agent | Get-JobSchedulerAgentStatus
Returns an array of status information objects each representing the state of an Agent in the cluster.