Modularization of Entra Powershell Module

build/Create-EntraModule.ps1

@@ -0,0 +1,35 @@
+
+[cmdletbinding()]
+param (
+    [string]$Module = "Entra",  # Default to "Entra" if no argument is provided
+    [switch]$Root
+)
+
+. (Join-Path $psscriptroot "/common-functions.ps1")
+. (Join-Path $psscriptroot "../src/EntraModuleBuilder.ps1")
+
+$moduleBuilder = [EntraModuleBuilder]::new()
+
+if($Module -eq 'Entra'){
+
+    $typeDefsPath=(Join-Path $PSScriptRoot "/V1.0-Typedefs.txt")
+}else{
+    $typeDefsPath=(Join-Path $PSScriptRoot "/Beta-TypeDefs.txt")
+}
+if($Root){
+    $moduleBuilder.CreateRootModuleManifest($Module)
+}else{
+    $moduleBuilder.CreateModuleHelp($Module)
+    $moduleBuilder.CreateSubModuleFile($Module, $typeDefsPath)
+    $moduleBuilder.CreateModuleManifest($Module)
+}
+
+
+if($Root){
+    $moduleBuilder.CreateRootModuleManifest($Module)
+}else{
+    $moduleBuilder.CreateModuleHelp($Module)
+    $moduleBuilder.CreateSubModuleFile($Module, $typeDefsPath)
+    $moduleBuilder.CreateModuleManifest($Module)
+}
+

build/Create-ModuleMapping.ps1

@@ -0,0 +1,75 @@
+# ------------------------------------------------------------------------------
+#  Copyright (c) Microsoft Corporation.  All Rights Reserved.  Licensed under the MIT License.  See License in the project root for license information.
+# ------------------------------------------------------------------------------
+
+#This function uses the moduleMapping.json to split the docs to subdirectories i.e. Key =SubModule name and
+# Value =an array of strings representing the files in that directory
+. ./common-functions.ps1
+function Get-DirectoryFileMap {
+    param (
+        [string]$Source = 'Entra' # Default to 'Entra'
+    )
+
+
+    # Determine the root directory and the output based on the Source parameter
+    switch ($Source) {
+        'Entra' {
+            $RootDirectory = "../module/Entra/Microsoft.Graph.Entra/"
+            $OutputDirectory = '../module/Entra/config/'
+        }
+        'EntraBeta' {
+            $RootDirectory = "../module/EntraBeta/Microsoft.Graph.Entra.Beta/"
+            $OutputDirectory = "../module/EntraBeta/config/"
+        }
+        default {
+            Log-Message "Invalid Source specified. Use 'Entra' or 'EntraBeta'." 'Error'
+            throw "Invalid Source specified. Use 'Entra' or 'EntraBeta'."
+        }
+    }
+
+    # Check if the root directory exists
+    if (-not (Test-Path -Path $RootDirectory -PathType Container)) {
+        Log-Message "Directory '$RootDirectory' does not exist." 'Error'
+        throw "Directory '$RootDirectory' does not exist."
+    } else {
+        Log-Message "Root directory '$RootDirectory' found."
+    }
+
+    # Check if the output directory exists, create if it doesn't
+    if (-not (Test-Path -Path $OutputDirectory -PathType Container)) {
+        New-Item -Path $OutputDirectory -ItemType Directory | Out-Null
+        Log-Message "Output directory '$OutputDirectory' did not exist, created it." 'Warning'
+    } else {
+        Log-Message "Output directory '$OutputDirectory' exists."
+    }
+
+    $fileDirectoryMap = @{}
+
+    # Get all the subdirectories under the root directory
+    $subDirectories = Get-ChildItem -Path $RootDirectory -Directory
+
+    foreach ($subDir in $subDirectories) {
+        Log-Message "Processing subdirectory '$($subDir.Name)'." 'Info'
+
+        # Get the files in each sub-directory without their extensions
+        $files = Get-ChildItem -Path $subDir.FullName -File | ForEach-Object {
+            $fileName = [System.IO.Path]::GetFileNameWithoutExtension($_.Name)
+            # Map the file name to the directory name
+            $fileDirectoryMap[$fileName] = $subDir.Name
+            Log-Message "Mapped file '$fileName' to directory '$($subDir.Name)'." 'Info'
+        }
+    }
+
+    # Convert the file-directory map to JSON
+    $jsonOutput = $fileDirectoryMap | ConvertTo-Json -Depth 3
+
+    # Define the output file path as moduleMapping.json
+    $outputFilePath = Join-Path -Path $OutputDirectory -ChildPath "newModuleMapping.json"
+
+    # Write the JSON output to moduleMapping.json
+    $jsonOutput | Out-File -FilePath $outputFilePath -Encoding UTF8
+
+    Log-Message "moduleMapping.json has been created at '$outputFilePath'." 'Info'
+}
+
+Get-DirectoryFileMap -Source 'Entra'

build/Split-Docs.ps1

@@ -0,0 +1,83 @@
+# ------------------------------------------------------------------------------
+#  Copyright (c) Microsoft Corporation.  All Rights Reserved.  Licensed under the MIT License.  See License in the project root for license information.
+# ------------------------------------------------------------------------------
+
+#This function copies the docs using the moduleMapping.json into their submodule directories
+# i.e. For each entry, it will use the Key(cmdlet name) and map it to the Value(A subdirectory created in the respective docs directory)
+
+. ./common-functions.ps1
+
+
+function Split-Docs {
+    param (
+        [string]$Module = 'Entra',  # Default to 'Entra'
+        [string]$OutputDirectory    # Allow custom output directory
+    )
+
+    # Determine source directories and mapping file paths based on the Source parameter
+    switch ($Module) {
+        'Entra' {
+            $DocsSourceDirectory = "../module/docs/entra-powershell-v1.0/Microsoft.Graph.Entra"
+            $MappingFilePath = '../moduleVNext/Entra/config/moduleMapping.json'
+            $OutputDirectory='../moduleVNext/docs/entra-powershell-v1.0'
+        }
+        'EntraBeta' {
+            $DocsSourceDirectory = "../module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta"
+            $MappingFilePath = "../moduleVNext/EntraBeta/config/moduleMapping.json"
+            $OutputDirectory="../moduleVNext/docs/entra-powershell-beta"
+        }
+        default {
+            Log-Message -Message "[Split-Docs]: Invalid Source specified. Use 'Entra' or 'EntraBeta'." -Level 'ERROR'
+            return
+        }
+    }
+
+    # Use the provided output directory or default to DocsSourceDirectory if none specified
+    $TargetRootDirectory = $OutputDirectory
+
+    # Check if the mapping file exists
+    if (-not (Test-Path -Path $MappingFilePath -PathType Leaf)) {
+        Log-Message -Message "[Split-Docs]: Mapping file '$MappingFilePath' does not exist." -Level 'ERROR'
+        return
+    }
+
+    # Load the JSON content from the mapping file
+    $moduleMapping = Get-Content -Path $MappingFilePath | ConvertFrom-Json
+
+    # Ensure the root documentation directory exists, create if it doesn't
+    if (-not (Test-Path -Path $TargetRootDirectory -PathType Container)) {
+        New-Item -Path $TargetRootDirectory -ItemType Directory | Out-Null
+        Log-Message -Message "[Split-Docs]: Created directory: $TargetRootDirectory" -Level 'SUCCESS'
+    }
+
+    # Iterate over each file-directory pair in the moduleMapping.json
+    foreach ($fileEntry in $moduleMapping.PSObject.Properties) {
+        $fileName = $fileEntry.Name      # Key (file name without extension)
+        $subDirName = $fileEntry.Value   # Value (sub-directory name)
+
+        # Create the sub-directory under the output root directory if it doesn't exist
+        $targetSubDir = Join-Path -Path $TargetRootDirectory -ChildPath $subDirName
+
+        if($subDirName -eq 'Migration' -or $subDirName -eq 'Invitations'){
+            Log-Message "[Split-Docs]: Skipping $subDirName" -Level 'WARNING'
+            continue
+        }
+        if (-not (Test-Path -Path $targetSubDir -PathType Container)) {
+            New-Item -Path $targetSubDir -ItemType Directory | Out-Null
+            Log-Message -Message "[Split-Docs]: Created sub-directory: $targetSubDir" -Level 'SUCCESS'
+        }
+
+        # Build the full source file path for the .md file
+        $sourceFile = Join-Path -Path $DocsSourceDirectory -ChildPath "$fileName.md"
+        if (Test-Path -Path $sourceFile -PathType Leaf) {
+            # Copy the .md file to the target sub-directory
+            Copy-Item -Path $sourceFile -Destination $targetSubDir
+            Log-Message -Message "[Split-Docs]: Copied '$sourceFile' to '$targetSubDir'" -Level 'SUCCESS'
+        } else {
+            # Log a warning if the .md file doesn't exist in the source directory
+            Log-Message -Message "[Split-Docs]: File '$fileName.md' not found in '$DocsSourceDirectory'" -Level 'WARNING'
+        }
+    }
+
+    Log-Message -Message "[Split-Docs]: Markdown file copying complete." -Level 'INFO'
+}

build/Split-EntraModule.ps1

@@ -0,0 +1,21 @@
+# ------------------------------------------------------------------------------
+#  Copyright (c) Microsoft Corporation.  All Rights Reserved.  Licensed under the MIT License.  See License in the project root for license information.
+# ------------------------------------------------------------------------------
+
+param (
+    [string]$Module = "Entra"  # Default to "Entra" if no argument is provided
+)
+
+# Import the necessary scripts
+. ..\src\EntraModuleSplitter.ps1
+. .\Split-Docs
+
+
+
+# Split the module and take into account the AzureADAliases as well
+$entraModuleSplitter = [EntraModuleSplitter]::new()
+$entraModuleSplitter.SplitEntraModule($Module)  # Pass the module argument
+$entraModuleSplitter.ProcessEntraAzureADAliases($Module)
+
+./Split-Docs.ps1 -Module $Module
+./Split-Tests.ps1 -Module $Module