UI-1: Add Additional Command Line Parameters

[jonnybottles]

Proposed Solution

Add consistent command line parameters to both investigation commands (Start-HawkTenantInvestigation and Start-HawkUserInvestigation) that allow specifying all configuration options currently handled through interactive prompts.

Parameters to add to both commands:

• IAgreeToTheEula (switch)
• SkipUpdate (switch)
• DaysToLookBack (integer, 1-365)
• StartDate (datetime)
• EndDate (datetime)
• OutputFolder (string path)
• Domain (string)

Technical Requirements

Parameter Implementation:

• Use standard PowerShell parameter attributes and validation.
• Maintain backward compatibility with existing interactive prompts when parameters aren't specified.
• Parameters should pass through to Initialize-HawkGlobalObject.

Input Validation Requirements:

• DaysToLookBack: Must be between 1-365 days.
• StartDate/EndDate:
  • Must be valid datetime objects.
  • StartDate must be before EndDate.
  • Date range cannot exceed 365 days.
• OutputFolder:
  • Must be a valid file system path.
  • Must have write permissions.
  • Create the folder if it doesn't exist.

Parameter Priority Logic:

• If both DaysToLookBack and StartDate are specified, StartDate takes precedence.
• If no date parameters are specified, default to a 90-day lookback.
• If EndDate is not specified, default to the current date.

Help Documentation:

• Update command help documentation to include new parameters.
• Add examples showing parameter usage.
• Document parameter validation rules.

---

Implementation Approach

1. Add Parameter Validation:

   • Implement validation for all parameters.
   • Create clear error messages for validation failures.
   • Handle edge cases appropriately.

2. Update Both Investigation Commands:

   • Add new parameters.
   • Implement validation logic.
   • Pass validated parameters to Initialize-HawkGlobalObject.
   • Maintain existing interactive prompts as a fallback.

3. Add Logging:

   • Log parameter values used.
   • Log validation failures.
   • Log parameter priority decisions.

---

Acceptance Criteria

• Both commands accept all listed parameters.
• All parameter validation rules are enforced.
• Parameters correctly pass through to Initialize-HawkGlobalObject.
• Interactive prompts still work when parameters are not specified.
• Help documentation is updated.
• Existing functionality is maintained when no parameters are used.

---

Dependencies

• Existing Initialize-HawkGlobalObject parameter handling.

---

Impact

This change will:

• Improve automation capabilities.
• Reduce manual intervention needed.
• Maintain backward compatibility.
• Add consistent parameter handling across commands.
• Improve validation and error handling.