Rename Instance parameter to Platform

Abierto
  • ¿Algo no está bien?
#187 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
68/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
powershell
Área
cli, cloud

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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,

Lenguaje dominante
PowerShell
Estrellas
1.4k
Forks
144
Merge medio
1 d 21 h
PR fusionados (30 d)
1

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de silverhack/monkey365

Todos los issues de silverhack/monkey365

Issues similares

Más issues de CLI

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.