Rename Instance parameter to Platform

Đang mở
#187 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
68/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
powershell
Lĩnh vực
cli, cloud

Hướng nghiên cứu

Start at the Invoke-Monkey365 command definition and trace every reference to the -Instance parameter, including the existing -Environment distinction. The work is done when the parameter is consistently exposed as -Platform and the Azure, Microsoft365, and EntraID examples use the new name without ambiguity.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

documentation enhancement help wanted impact-low priority-medium question

Is your feature request related to a problem? Please describe.

The -Instance parameter was introduced when Monkey365 only supported a limited number of Azure and Microsoft 365 collectors.

Since then, the project has evolved into a collector-based PowerShell framework with support for multiple platforms, each exposing its own set of collectors and declarative security rules.

Each platform (Azure, EntraID or Microsoft365) contains collectors for different services and workloads, for example:

  • Exchange Online
  • SharePoint Online
  • Microsoft Purview
  • Virtual Machines
  • Key Vault
  • Storage Accounts
  • Network Security Groups
  • RBAC
  • PIM
  • App Registrations
  • Enterprise Applications
  • Conditional Access

The name -Instance no longer accurately describes what the parameter represents. It is also easy to confuse with the existing -Environment parameter, which is used to select the target Microsoft cloud (AzurePublic, AzureChina, AzureUSGovernment, etc.).

Describe the solution you'd like

Rename -Instance to -Platform.

Examples:

Invoke-Monkey365 -Platform Azure -Collect VirtualMachine,StorageAccount -ExportTo JSON

Invoke-Monkey365 -Platform Microsoft365 -Collect ExchangeOnline,SharePointOnline -IncludeEntraID -ExportTo HTML

I believe that -Platform better reflects the current architecture and also scales naturally if additional platforms (Azure DevOps!) are added in the future.

As always, I'd appreciate any feedback or suggestions before moving forward with this change.

Thanks,

Ngôn ngữ chính
PowerShell
Star
1.4k
Fork
144
Merge trung bình
1 ngày 21 giờ
Pull request đã merge (30 ngày)
1

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của silverhack/monkey365

Tất cả issue của silverhack/monkey365

Issue tương tự

Thêm issue về CLI

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.