LESSON 1 OF 4
Design the evidence object before the command
Your practical task
Design a read-only triage report that records evidence and refuses to equate ping failure with device failure.
A daily ticket export mixes lowercase and uppercase priorities. A script that matches one spelling misses incidents. Build an accurate report from synthetic tickets before considering any live service-desk integration.
How the system works
A service-desk script should narrow a support question before collecting data. Device reachability, name resolution and service availability are different checks. Ping may be blocked while an application remains available. A service name can resolve while the application behind it is failing. A good report stores separate observations and avoids a single healthy boolean that conceals these differences.
This lab separates the assessment function from collection. You can test how the report interprets evidence without contacting a machine. A production collector could provide DNS, ICMP and application-test results, but those integrations would need permission, environment-specific behaviour and timeouts. The training function does not claim to perform them.
The classifier has explicit UNKNOWN values. If the application check did not run, neither OK nor FAILED is justified. The recommended next action is tied to the missing or failing evidence. It is a handoff recommendation, not an automatic remediation instruction. A support script should not restart services or reset identities merely because an incomplete report contains a failure.
Design the evidence object before the command
A support script should answer a defined question using a consistent record. Choose fields such as Computer, ObservationTime, Target, Dns, Transport, Application, Source and CollectionError. Do not merge failed, unknown and not attempted into the same Boolean value.
A function that returns objects can support both human display and machine export. Formatting belongs at the presentation boundary: Format-Table creates formatting instructions, so it should not be piped into Export-Csv as though it were your business objects. Keep raw observations and derived classifications separate so an operator can challenge the classification.
Reasoning model
A support script should make incomplete evidence visible. “No rows returned” can mean no findings, inaccessible source or parsing failure. Use a stable record schema with status and reason, separate collection from decisions, and require deliberate authorization for any remediation. A preview mechanism is useful only when the modifying commands participate correctly; the presence of a switch name does not prove no changes can occur.
YOUR NEXT STEP
Keep building your skills
No directly related CogniSkill book is mapped to this course yet. Continue with the free learning, or compare the publishing catalogue by your next goal.
Explore books by topic and goal →Sign in to save lesson completion. Reading position is separate from completion.
Practice notes — your working space
Save predictions, outputs and explanations as you work. Notes stay on this browser, not your account; people sharing this browser can access them. Avoid passwords and sensitive data. Export to keep a portable copy, or clear your notes before leaving a shared device.
How was this lesson?
Help us improve this lesson.