Merge pull request #3299 from microsoftgraph/fix-example-formatting

Updates example import script to fix formatting issues

Author: timayabi2020

src/DeviceManagement.Enrollment/beta/examples/New-MgBetaRoleManagementCloudPcRoleDefinition.md

@@ -1,12 +1,12 @@
-### Example 1: Code snippet
+### Example 2: Code snippet
 
 ```powershell
 
 Import-Module Microsoft.Graph.Beta.DeviceManagement.Enrollment
 
 $params = @{
 	description = "An example custom role"
-### Example 2
+	displayName = "ExampleCustomRole"
 	rolePermissions = @(
 		@{
 			allowedResourceActions = @(

src/DeviceManagement.Enrollment/beta/examples/Update-MgBetaRoleManagementCloudPcRoleDefinition.md

@@ -1,12 +1,12 @@
-### Example 1: Code snippet
+### Example 2: Code snippet
 
 ```powershell
 
 Import-Module Microsoft.Graph.Beta.DeviceManagement.Enrollment
 
 $params = @{
 	description = "Update basic properties and permission of application registrations"
-### Example 2
+	displayName = "ExampleCustomRole"
 	rolePermissions = @(
 		@{
 			allowedResourceActions = @(

src/readme.graph.md

@@ -957,11 +957,6 @@ directive:
       subject: ^User$
     set:
       alias: Set-Mg${subject-prefix}${subject}
-  - where:
-      verb: (Get|New|Update|Remove|Set|Invoke|Create)
-      subject: ^(.*)(OnPremise)(.*)$
-    set:
-      alias: ^(.*)(OnPremises)(.*)$
 
 # Setting the alias below as per the request on issue [#3241](https://github.com/microsoftgraph/msgraph-sdk-powershell/issues/3241)
 

tools/ImportExamples.ps1

@@ -268,12 +268,14 @@ function Update-ExampleFile {
     $SearchTextForNewImports = "{{ Add description here }}"
     $ReplaceEverything = $False
     if ($HeaderList.Count -eq 0) {
+        Write-Host "The header list is empty. Please check the external docs url."
         for ($d = 0; $d -lt $ExampleList.Count; $d++) {
             $sum = $d + 1
             $HL = $HeaderList.Add("### Example " + $sum + ": Code snippet".Trim())
         }
     }
     if ($HeaderList.Count -ne $ExampleList.Count) {
+        Write-Host "The number of examples and the number of headers are not equal. Please check the external docs url."
         $HeaderList.Clear()
         for ($d = 0; $d -lt $ExampleList.Count; $d++) {
             $sum = $d + 1
@@ -286,6 +288,14 @@ function Update-ExampleFile {
     }
     $HeadCount = $HeaderList.Count
     $ExampleCount = $ExampleList.Count
+    #On the example list check the one that contains the command pattern and if doesn't match remove it from the list. Also remove the header from the header list
+    for ($x = 0; $x -lt $HeaderList.Count; $x++) {
+        if ($ExampleList[$x] -notmatch "\b$CommandPattern\b") {
+            $ExampleList.RemoveAt($x)
+            $HeaderList.RemoveAt($x)
+        }
+    }
+
     $WrongExamplesCount = 0;
     $SkippedExample = -1
     $TotalText = ""
@@ -298,9 +308,12 @@ function Update-ExampleFile {
         Clear-Content $ExampleFile -Force
         for ($d = 0; $d -lt $HeaderList.Count; $d++) { 
             $CodeValue = $ExampleList[$d].Trim()
+           
             if ($CodeValue -match "\b$CommandPattern\b") {
+                Write-Host $CodeValue
                 $TitleValue = $HeaderList[$d].Trim()
                 $TitleDesc = $TitleValue
+
                 if (-not($TitleValue.Contains("Code snippet"))) {
                     if ($TitleDesc -match $DescriptionRegex) {
                         $TitleDesc = $TitleDesc -replace $DescriptionRegex, ''
@@ -593,4 +606,4 @@ Start-Generator -ModulesToGenerate $ModulesToGenerate -GenerationMode "auto"
 
 #4. Test for beta updates from api reference
 #Start-Generator -GenerationMode "manual" -ManualExternalDocsUrl "https://docs.microsoft.com/graph/api/serviceprincipal-post-approleassignedto?view=graph-rest-beta" -GraphCommand "New-MgBetaServicePrincipalAppRoleAssignedTo" -GraphModule "Applications" -Profile "beta"
-#Start-Generator -GenerationMode "manual" -ManualExternalDocsUrl "https://learn.microsoft.com/en-us/graph/api/synchronization-synchronization-list-templates?view=graph-rest-beta&tabs=powershell" -GraphCommand "Get-MgBetaServicePrincipalSynchronizationTemplate" -GraphModule "Applications" -Profile "beta"
+#Start-Generator -GenerationMode "manual" -ManualExternalDocsUrl "https://learn.microsoft.com/graph/api/rbacapplication-post-roledefinitions?view=graph-rest-beta" -GraphCommand "New-MgBetaRoleManagementCloudPcRoleDefinition" -GraphModule "DeviceManagement.Enrollment" -Profile "beta"