From 533442832dbf6688d52cd3b89fab9e79012ee0ce Mon Sep 17 00:00:00 2001
From: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Date: Fri, 2 Aug 2024 03:34:21 +0000
Subject: [PATCH] Updating examples

---
 ...ServicePrincipalSynchronizationTemplate.md | 11 -------
 ...ReportCrossRegionDisasterRecoveryReport.md | 32 +++++++++++++++++++
 .../beta/examples/Get-MgBetaDriveItem.md      | 10 +++---
 .../beta/examples/Confirm-MgBetaDomain.md     | 19 +++++++++--
 .../examples/Get-MgAdminPeopleItemInsight.md  | 11 +++++++
 ...taIdentityGovernanceTermsOfUseAgreement.md | 17 ++++++++--
 ...atIntelligenceSslCertificateRelatedHost.md | 11 +++++++
 7 files changed, 90 insertions(+), 21 deletions(-)
 create mode 100644 src/DeviceManagement.Actions/beta/examples/Get-MgBetaDeviceManagementVirtualEndpointReportCrossRegionDisasterRecoveryReport.md
 create mode 100644 src/Identity.DirectoryManagement/v1.0/examples/Get-MgAdminPeopleItemInsight.md
 create mode 100644 src/Security/beta/examples/Get-MgBetaSecurityThreatIntelligenceSslCertificateRelatedHost.md

diff --git a/src/Applications/beta/examples/Get-MgBetaServicePrincipalSynchronizationTemplate.md b/src/Applications/beta/examples/Get-MgBetaServicePrincipalSynchronizationTemplate.md
index 3f1ed3342c..e69de29bb2 100644
--- a/src/Applications/beta/examples/Get-MgBetaServicePrincipalSynchronizationTemplate.md
+++ b/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 will### example
-
diff --git a/src/DeviceManagement.Actions/beta/examples/Get-MgBetaDeviceManagementVirtualEndpointReportCrossRegionDisasterRecoveryReport.md b/src/DeviceManagement.Actions/beta/examples/Get-MgBetaDeviceManagementVirtualEndpointReportCrossRegionDisasterRecoveryReport.md
new file mode 100644
index 0000000000..a6a35fbc75
--- /dev/null
+++ b/src/DeviceManagement.Actions/beta/examples/Get-MgBetaDeviceManagementVirtualEndpointReportCrossRegionDisasterRecoveryReport.md
@@ -0,0 +1,32 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.DeviceManagement.Actions
+
+$params = @{
+	filter = "DisasterRecoveryStatus eq 'Active outage'"
+	select = @(
+	"Id"
+"CloudPcId"
+"UserId"
+"UserSettingId"
+"DeviceId"
+"CloudPCDeviceDisplayName"
+"UserPrincipalName"
+"IsCrossRegionEnabled"
+"CrossRegionHealthStatus"
+"LicenseType"
+"DisasterRecoveryStatus"
+"CurrentRestorePointDateTime"
+"ActivationExpirationDateTime"
+)
+skip = 0
+top = 50
+}
+
+Get-MgBetaDeviceManagementVirtualEndpointReportCrossRegionDisasterRecoveryReport -BodyParameter $params
+
+```
+This example shows how to use the Get-MgBetaDeviceManagementVirtualEndpointReportCrossRegionDisasterRecoveryReport Cmdlet.
+
diff --git a/src/Files/beta/examples/Get-MgBetaDriveItem.md b/src/Files/beta/examples/Get-MgBetaDriveItem.md
index b16b77173e..659b575d21 100644
--- a/src/Files/beta/examples/Get-MgBetaDriveItem.md
+++ b/src/Files/beta/examples/Get-MgBetaDriveItem.md
@@ -1,11 +1,11 @@
-### Example 1: Get a bundle and its children in a single call
+### Example 1: Get metadata about a shared driveItem object
 
 ```powershell
+
 Import-Module Microsoft.Graph.Beta.Files
 
-Get-MgBetaDriveItem -DriveId $driveId -DriveItemId $driveItemId -ExpandProperty "children"
-```
-This example shows how to use the Get-MgBetaDriveItem Cmdlet.
+Get-MgBetaDriveItem -DriveId $driveId -DriveItemId $driveItemId
 
-To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+```
+This example will get metadata about a shared driveitem object
 
diff --git a/src/Identity.DirectoryManagement/beta/examples/Confirm-MgBetaDomain.md b/src/Identity.DirectoryManagement/beta/examples/Confirm-MgBetaDomain.md
index 094499afe2..d3350bd43c 100644
--- a/src/Identity.DirectoryManagement/beta/examples/Confirm-MgBetaDomain.md
+++ b/src/Identity.DirectoryManagement/beta/examples/Confirm-MgBetaDomain.md
@@ -1,4 +1,4 @@
-### Example 1: Code snippet
+### Example 1: Verify a domain
 
 ```powershell
 
@@ -7,5 +7,20 @@ Import-Module Microsoft.Graph.Beta.Identity.DirectoryManagement
 Confirm-MgBetaDomain -DomainId $domainId
 
 ```
-This example shows how to use the Confirm-MgBetaDomain Cmdlet.
+This example will verify a domain
+
+### Example 2: External admin takeover of a domain
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.Identity.DirectoryManagement
+
+$params = @{
+	forceTakeover = $true
+}
+
+Confirm-MgBetaDomain -DomainId $domainId -BodyParameter $params
+
+```
+This example will external admin takeover of a domain
 
diff --git a/src/Identity.DirectoryManagement/v1.0/examples/Get-MgAdminPeopleItemInsight.md b/src/Identity.DirectoryManagement/v1.0/examples/Get-MgAdminPeopleItemInsight.md
new file mode 100644
index 0000000000..6f9672aa61
--- /dev/null
+++ b/src/Identity.DirectoryManagement/v1.0/examples/Get-MgAdminPeopleItemInsight.md
@@ -0,0 +1,11 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Identity.DirectoryManagement
+
+Get-MgAdminPeopleItemInsight
+
+```
+This example shows how to use the Get-MgAdminPeopleItemInsight Cmdlet.
+
diff --git a/src/Identity.Governance/beta/examples/Get-MgBetaIdentityGovernanceTermsOfUseAgreement.md b/src/Identity.Governance/beta/examples/Get-MgBetaIdentityGovernanceTermsOfUseAgreement.md
index fef3def2a4..35a94b1363 100644
--- a/src/Identity.Governance/beta/examples/Get-MgBetaIdentityGovernanceTermsOfUseAgreement.md
+++ b/src/Identity.Governance/beta/examples/Get-MgBetaIdentityGovernanceTermsOfUseAgreement.md
@@ -1,11 +1,22 @@
-### Example 1: Code snippet
+### Example 1: Retrieve an agreement
 
 ```powershell
 
 Import-Module Microsoft.Graph.Beta.Identity.Governance
 
-Get-MgBetaIdentityGovernanceTermsOfUseAgreement
+Get-MgBetaIdentityGovernanceTermsOfUseAgreement -AgreementId $agreementId
 
 ```
-This example shows how to use the Get-MgBetaIdentityGovernanceTermsOfUseAgreement Cmdlet.
+This example will retrieve an agreement
+
+### Example 2: Retrieve an agreement and its related files
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.Identity.Governance
+
+Get-MgBetaIdentityGovernanceTermsOfUseAgreement -AgreementId $agreementId -ExpandProperty "files" 
+
+```
+This example will retrieve an agreement and its related files
 
diff --git a/src/Security/beta/examples/Get-MgBetaSecurityThreatIntelligenceSslCertificateRelatedHost.md b/src/Security/beta/examples/Get-MgBetaSecurityThreatIntelligenceSslCertificateRelatedHost.md
new file mode 100644
index 0000000000..f5115210cb
--- /dev/null
+++ b/src/Security/beta/examples/Get-MgBetaSecurityThreatIntelligenceSslCertificateRelatedHost.md
@@ -0,0 +1,11 @@
+### Example 1: Code snippet
+
+```powershell
+
+Import-Module Microsoft.Graph.Beta.Security
+
+Get-MgBetaSecurityThreatIntelligenceSslCertificateRelatedHost -SslCertificateId $sslCertificateId
+
+```
+This example shows how to use the Get-MgBetaSecurityThreatIntelligenceSslCertificateRelatedHost Cmdlet.
+