Merge branch 'dev' into WeeklyApiRefresh/202504281452

Author: timayabi2020

src/Applications/beta/examples/Get-MgBetaServicePrincipalSynchronizationTemplate.md

@@ -1,11 +0,0 @@
-### Example
-
-```powershell
-
-Import-Module Microsoft.Graph.Beta.Applications
-
-Get-MgBetaServicePrincipalSynchronizationTemplate -ServicePrincipalId $servicePrincipalId
-
-```
-This example shows how to use the Get-MgBetaServicePrincipalSynchronizationTemplate Cmdlet.
-

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/DeviceManagement/beta/examples/Get-MgBetaDeviceManagementComanagedDeviceCloudPcRemoteActionResult.md

@@ -0,0 +1 @@
+

src/DeviceManagement/beta/examples/Get-MgBetaDeviceManagementComanagedDeviceCloudPcReviewStatus.md

@@ -0,0 +1 @@
+

src/DeviceManagement/beta/examples/Get-MgBetaDeviceManagementManagedDeviceCloudPcRemoteActionResult.md

@@ -0,0 +1,11 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DeviceManagement
+
+Get-MgBetaDeviceManagementManagedDeviceCloudPcRemoteActionResult -ManagedDeviceId $managedDeviceId
+
+```
+This example shows how to use the Get-MgBetaDeviceManagementManagedDeviceCloudPcRemoteActionResult Cmdlet.
+

src/DeviceManagement/beta/examples/Get-MgBetaDeviceManagementManagedDeviceCloudPcReviewStatus.md

@@ -0,0 +1,11 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DeviceManagement
+
+Get-MgBetaDeviceManagementManagedDeviceCloudPcReviewStatus -ManagedDeviceId $managedDeviceId
+
+```
+This example shows how to use the Get-MgBetaDeviceManagementManagedDeviceCloudPcReviewStatus Cmdlet.
+

src/DirectoryObjects/beta/examples/Confirm-MgBetaDirectoryObjectMemberGroup.md

@@ -1 +1,21 @@
+### Example 1: Check group memberships for a directory object
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DirectoryObjects
+
+$params = @{
+	groupIds = @(
+	"f448435d-3ca7-4073-8152-a1fd73c0fd09"
+"bd7c6263-4dd5-4ae8-8c96-556e1c0bece6"
+"93670da6-d731-4366-94b5-abed40b6016b"
+"f5484ab1-4d4d-41ec-a9b8-754b3957bfc7"
+"c9103f26-f3cf-4004-a611-2a14e81b8f79"
+)
+}
+
+Confirm-MgBetaDirectoryObjectMemberGroup -DirectoryObjectId $directoryObjectId -BodyParameter $params
+
+```
+This example will check group memberships for a directory object
 

src/DirectoryObjects/beta/examples/Get-MgBetaDirectoryObject.md

@@ -0,0 +1,11 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DirectoryObjects
+
+Get-MgBetaDirectoryObject -DirectoryObjectId $directoryObjectId
+
+```
+This example shows how to use the Get-MgBetaDirectoryObject Cmdlet.
+

src/DirectoryObjects/beta/examples/Get-MgBetaDirectoryObjectById.md

@@ -0,0 +1,25 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DirectoryObjects
+
+$params = @{
+	ids = @(
+	"84b80893-8749-40a3-97b7-68513b600544"
+"5d6059b6-368d-45f8-91e1-8e07d485f1d0"
+"0b944de3-e0fc-4774-a49a-b135213725ef"
+"b75a5ab2-fe55-4463-bd31-d21ad555c6e0"
+)
+types = @(
+"user"
+"group"
+"device"
+)
+}
+
+Get-MgBetaDirectoryObjectById -BodyParameter $params
+
+```
+This example shows how to use the Get-MgBetaDirectoryObjectById Cmdlet.
+

src/DirectoryObjects/beta/examples/Get-MgBetaDirectoryObjectDelta.md

@@ -0,0 +1,44 @@
+### Example 1: Retrieve changes for a collection of users and groups
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DirectoryObjects
+
+Get-MgBetaDirectoryObjectDelta -Filter "isof('microsoft.graph.user') or isof('microsoft.graph.group')" 
+
+```
+This example will retrieve changes for a collection of users and groups
+
+### Example 2: Retrieve a collection of changes for a directory object
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DirectoryObjects
+
+Get-MgBetaDirectoryObjectDelta -Filter "id eq '87d349ed-44d7-43e1-9a83-5f2406dee5bd'" 
+
+```
+This example will retrieve a collection of changes for a directory object
+
+### Example 3: Retrieve changes to specific properties for a collection of users and groups
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DirectoryObjects
+
+Get-MgBetaDirectoryObjectDelta -Filter "isof('microsoft.graph.user') or isof('microsoft.graph.group')" -Property "microsoft.graph.user/surname,microsoft.graph.group/displayName" 
+
+```
+This example will retrieve changes to specific properties for a collection of users and groups
+
+### Example 4: Retrieve specific properties only if they changed for a collection of users and groups
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DirectoryObjects
+
+Get-MgBetaDirectoryObjectDelta -Filter "isof('microsoft.graph.user') or isof('microsoft.graph.group')" -Property "microsoft.graph.user/surname,microsoft.graph.group/displayName" 
+
+```
+This example will retrieve specific properties only if they changed for a collection of users and groups
+

src/DirectoryObjects/beta/examples/Get-MgBetaDirectoryObjectMemberGroup.md

@@ -1 +1,15 @@
+### Example 1: Check group memberships for a directory object
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DirectoryObjects
+
+$params = @{
+	securityEnabledOnly = $false
+}
+
+Get-MgBetaDirectoryObjectMemberGroup -DirectoryObjectId $directoryObjectId -BodyParameter $params
+
+```
+This example will check group memberships for a directory object
 

src/DirectoryObjects/v1.0/examples/Confirm-MgDirectoryObjectMemberGroup.md

@@ -1 +1,21 @@
+### Example 1: Check group memberships for a directory object
+
+```powershell
+
+Import-Module Microsoft.Graph.DirectoryObjects
+
+$params = @{
+	groupIds = @(
+	"f448435d-3ca7-4073-8152-a1fd73c0fd09"
+"bd7c6263-4dd5-4ae8-8c96-556e1c0bece6"
+"93670da6-d731-4366-94b5-abed40b6016b"
+"f5484ab1-4d4d-41ec-a9b8-754b3957bfc7"
+"c9103f26-f3cf-4004-a611-2a14e81b8f79"
+)
+}
+
+Confirm-MgDirectoryObjectMemberGroup -DirectoryObjectId $directoryObjectId -BodyParameter $params
+
+```
+This example will check group memberships for a directory object
 

src/Identity.DirectoryManagement/beta/examples/Get-MgBetaAdminPeopleNamePronunciation.md

@@ -0,0 +1,11 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.Identity.DirectoryManagement
+
+Get-MgBetaAdminPeopleNamePronunciation
+
+```
+This example shows how to use the Get-MgBetaAdminPeopleNamePronunciation Cmdlet.
+

src/Security/beta/examples/Get-MgBetaSecurityCaseEdiscoveryCaseMember.md

@@ -0,0 +1,11 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.Security
+
+Get-MgBetaSecurityCaseEdiscoveryCaseMember -EdiscoveryCaseId $ediscoveryCaseId
+
+```
+This example shows how to use the Get-MgBetaSecurityCaseEdiscoveryCaseMember Cmdlet.
+

src/Teams/v1.0/examples/Confirm-MgGroupTeamScheduleTimeCard.md

@@ -0,0 +1 @@
+

src/Teams/v1.0/examples/Confirm-MgTeamScheduleTimeCard.md

@@ -0,0 +1,11 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Teams
+
+Confirm-MgTeamScheduleTimeCard -TeamId $teamId -TimeCardId $timeCardId
+
+```
+This example shows how to use the Confirm-MgTeamScheduleTimeCard Cmdlet.
+

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"