NAME
Get-JobSchedulerAgentStatus
SYNOPSIS
Return summary information and statistics information from a JobScheduler Agent.
SYNTAX
Get-JobSchedulerAgentStatus [-Url <Uri>] [-Agents <Uri[]>] [-Path <String>] [-Timeout <Int32>] -Display [-NoO
utputs] <CommonParameters>
DESCRIPTION
Summary information and statistics information 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?
Agents
-Agents <Uri[]>
Specifies an array of URLs that point to Agents. This is useful if a number of Agents
should be checked at the same time, e.g. should the Agents from the result of the
Get-AgentCluster cmdlet be checked.
This parameter cannot be specified if the -Url parameter is used.
Required? false
Position? 2
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters?
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
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
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: 1000 ms
Required? false
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
Display
-Display <SwitchParameter>
Optionally specifies formatted output to be displayed.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
NoOutputs
-NoOutputs <SwitchParameter>
Optionally specifies that no output is returned by this cmdlet.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
RELATED LINKS
about_jobscheduler
EXAMPLES
-------------------------- EXAMPLE 1 --------------------------
C:\PS>Get-AgentStatus http://localhost:4455
Returns summary information about the JobScheduler Agent.
-------------------------- EXAMPLE 2 --------------------------
C:\PS>Get-AgentStatus -Url http://localhost:4455 -Display
Returns summary information about the Agent. Formatted output is displayed.
-------------------------- EXAMPLE 3 --------------------------
C:\PS>$status = Get-AgentStatus http://localhost:4455
Returns a status information object.
-------------------------- EXAMPLE 4 --------------------------
C:\PS>$status = Get-AgentCluster /agent/fixed_priority_scheduling_agent | Get-AgentStatus
Returns an array of status information objects each representing the state of an Agent in the cluster.