Get-CatSession
Returns the current CAT session — the effective plan and its limits, the resolved license key, and the open project.
Synopsis
Get-CatSession
Parameters
None (common parameters only).
What it does
Writes the session object the module created with the last Open-CatProject / Invoke-CatProject (or New-CatProject / Get-CatProjectTemplate). It answers the questions Get-CatInstance cannot: which plan applies, what does it limit, which license key was resolved?
Output
One CatSession object; the useful properties:
| Property | Meaning |
|---|---|
SignedInUser |
Always empty in the module: it never signs in. |
EffectivePlan |
The plan in force: Starter, Team, Enterprise (or legacy Business). |
CurrentLimitations |
What the plan allows: AllowedTools, InteractiveUsageOnly, OutputsAllowed, MaximumNumberOfTestsPerRun, MaximumNumberOfThreads, ExpiryDate, SignInRequired, ChecksPerDay. |
ResolvedLicenseKey |
The key CAT resolved: Status (Valid, Expired, Future, NotSet, …), Plan, ValidFrom, ValidTo. |
Project |
The open project (the same object as Get-CatProject). |
LatestRunSummary |
The result of the last run (the same object as Get-CatTestResultSummary). |
InvocationContext |
AutomationPlatform, Scheduler, ToolVersion, CoreVersion, operating system. |
SessionID |
Identifier of this session. |
Errors
There is no CAT session active. It will be created once you use Open-CatProject. when no session exists yet.
Examples
Open-CatProject
$s = Get-CatSession
$s.EffectivePlan
$s.ResolvedLicenseKey | Select-Object Status, Plan, ValidTo
$s.CurrentLimitations.InteractiveUsageOnly
Related
- Introduction — session model, logging, errors, plans and the license key.
Get-CatInstance— the installation (works without a session).