Versions Compared

Key

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

...

Get-JS7AgentReport

SYNOPSIS

Return Returns reporting information about job executions from a JS7 Agent.

SYNTAX

Get-JS7AgentReport [[-AgentId] <String[]>] [[-AgentsAgentUrl] <Uri[]>] [[-ControllerId] <String>] [[-DateFrom] <DateTime>] [[-DateTo] <DateTime>] [-Display] [<CommonParameters>]

...

Reporting information about job executions is returned from a JS7 Agent.
*
Reporting information includes e.g. the number of successfully executed tasks with an Agent.

The following REST Web Service API resources are used:

* /agents/report

PARAMETERS

AgentId

-AgentId <String[]>
Optionally specifies the unique identifier of an Agent. More than one Agent identifier can be specified using a comma.

Without the -AgentId and -AgentUrl parameters the report is created for all Agents registered with a Controller.

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

AgentUrl

-AgentUrl -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 checked Optionally specifies the URL that points to an Agent. More than one Agent URL can be specified using a comma.

Without the -AgentId and -AgentUrl parameters the report is created for all Agents registered with a Controller.

Required?false
Position?12
Default value
Accept pipeline input?true (ByValue, ByPropertyName)
Accept wildcard characters?false

ControllerId

-ControllerId <String>
Optionally limits reporting results to Agents that are registered with the specified Controller.

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

DateFrom

-DateFrom <DateTime>
Specifies the date starting from which job executions are reported.

Required?false
Position?24
Default value(Get-Date -Hour 0 -Minute 00 -Second 00).ToUniversalTime()
Accept pipeline input?true (ByPropertyName)false
Accept wildcard characters?false

...

-DateTo <DateTime>
Specifies the date up to which job executions are reported.

Required?false
Position?35
Default value(Get-Date).ToUniversalTime()
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

Required?false
Position?named
Default valueFalse
Accept pipeline input?falsetrue (ByValue, ByPropertyName)
Accept wildcard characters?false

...

-------------------------- EXAMPLE 1 --------------------------

PS > Get-JobSchedulerAgentReport JS7AgentReport -Display -DateFrom 2020-01-01

Displays reporting information about job executions sind with any Agents since first of January 2020.

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

PS > Get-JobSchedulerAgentReport -Agents JS7AgentReport -AgentUrl http://host-a:4445,http://localhosthost-b:4445 -Display

Returns reporting information about Agent job executions with the indicated Agents for today. Formatted output is displayed.

-------------------------- EXAMPLE 3 --------------------------

PS > $report = Get-JobSchedulerAgentReport JS7AgentReport -DateFrom 2020-04-01 -DateTo 2020-06-30

...