Corrected titles

Author: timayabi2020

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Add-MgApplicationKey.md

@@ -55,8 +55,7 @@ Applications that don't have any existing valid certificates (no certificates ha
 You can use the Update application operation to perform an update instead.
 
 ## EXAMPLES
-
-### EXAMPLE 1
+### Example 1: Using the Add-MgApplicationKey Cmdlet
 ```powershell
 Import-Module Microsoft.Graph.Applications
 $params = @{
@@ -70,8 +69,9 @@ $params = @{
 }
 Add-MgApplicationKey -ApplicationId $applicationId -BodyParameter $params
 ```
-
-### EXAMPLE 2
+This example shows how to use the Add-MgApplicationKey Cmdlet.
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+### Example 2: Using the Add-MgApplicationKey Cmdlet
 ```powershell
 Import-Module Microsoft.Graph.Applications
 $params = @{
@@ -87,6 +87,8 @@ $params = @{
 }
 Add-MgApplicationKey -ApplicationId $applicationId -BodyParameter $params
 ```
+This example shows how to use the Add-MgApplicationKey Cmdlet.
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
 
 ## PARAMETERS
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Add-MgApplicationPassword.md

@@ -45,11 +45,11 @@ Add-MgApplicationPassword -InputObject <IApplicationsIdentity>
 Adds a strong password or secret to an application.
 
 ## EXAMPLES
+### Example 1: Add a password credential to an application with a six month expiry
 
-### EXAMPLE 1
 ```powershell
+
 Connect-MgGraph -Scopes 'Application.ReadWrite.All'
-```
 
 $appObjectId = 'eaf1e531-0d58-4874-babe-b9a9f436e6c3'
 
@@ -70,11 +70,15 @@ SecretText           : Q_e8Q~ZDWJD.bkgajbREp-VFFUayCuEk8b1hDcr9
 StartDateTime        : 26/5/2022 1:03:31 pm
 AdditionalProperties : {[@odata.context,
                        https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.passwordCredential]}
+```
+
+Add a password to an application that expires in six months from the current date.
+
+### Example 2: Add a password credential to an application with a start date
 
-### EXAMPLE 2
 ```powershell
+
 Connect-MgGraph -Scopes 'Application.ReadWrite.All'
-```
 
 $appObjectId = 'eaf1e531-0d58-4874-babe-b9a9f436e6c3'
 
@@ -99,6 +103,11 @@ SecretText           : TiA8Q~Zs7ej1cGtlW0qnmuFi~JlxXTZew_tU1bGA
 StartDateTime        : 26/5/2022 2:00:00 pm
 AdditionalProperties : {[@odata.context,
                        https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.passwordCredential]}
+```
+
+Add a password to an application that becomes valid at 12:00 am the next day and is valid for six months.
+
+Use `$secret.StartDateTime.ToLocalTime()` to convert the returned dates from UTC to the local timezone.
 
 ## PARAMETERS
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Add-MgServicePrincipalKey.md

@@ -52,8 +52,7 @@ ServicePrincipals that don't have any existing valid certificates (i.e.: no cert
 Update servicePrincipal can be used to perform an update instead.
 
 ## EXAMPLES
-
-### EXAMPLE 1
+### Example 1: Using the Add-MgServicePrincipalKey Cmdlet
 ```powershell
 Import-Module Microsoft.Graph.Applications
 $params = @{
@@ -67,8 +66,9 @@ $params = @{
 }
 Add-MgServicePrincipalKey -ServicePrincipalId $servicePrincipalId -BodyParameter $params
 ```
-
-### EXAMPLE 2
+This example shows how to use the Add-MgServicePrincipalKey Cmdlet.
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+### Example 2: Using the Add-MgServicePrincipalKey Cmdlet
 ```powershell
 Import-Module Microsoft.Graph.Applications
 $params = @{
@@ -84,6 +84,8 @@ $params = @{
 }
 Add-MgServicePrincipalKey -ServicePrincipalId $servicePrincipalId -BodyParameter $params
 ```
+This example shows how to use the Add-MgServicePrincipalKey Cmdlet.
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
 
 ## PARAMETERS
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Add-MgServicePrincipalPassword.md

@@ -42,8 +42,7 @@ Add-MgServicePrincipalPassword -InputObject <IApplicationsIdentity>
 Add a strong password or secret to a servicePrincipal object.
 
 ## EXAMPLES
-
-### EXAMPLE 1
+### Example 1: Using the Add-MgServicePrincipalPassword Cmdlet
 ```powershell
 Import-Module Microsoft.Graph.Applications
 $params = @{
@@ -53,6 +52,8 @@ $params = @{
 }
 Add-MgServicePrincipalPassword -ServicePrincipalId $servicePrincipalId -BodyParameter $params
 ```
+This example shows how to use the Add-MgServicePrincipalPassword Cmdlet.
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
 
 ## PARAMETERS
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Add-MgServicePrincipalTokenSigningCertificate.md

@@ -60,8 +60,7 @@ The **startDateTime** is set to the same time the certificate is created using t
 The **endDateTime** can be up to three years after the certificate is created.
 
 ## EXAMPLES
-
-### EXAMPLE 1
+### Example 1: Using the Add-MgServicePrincipalTokenSigningCertificate Cmdlet
 ```powershell
 Import-Module Microsoft.Graph.Applications
 $params = @{
@@ -70,6 +69,8 @@ $params = @{
 }
 Add-MgServicePrincipalTokenSigningCertificate -ServicePrincipalId $servicePrincipalId -BodyParameter $params
 ```
+This example shows how to use the Add-MgServicePrincipalTokenSigningCertificate Cmdlet.
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
 
 ## PARAMETERS
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Clear-MgApplicationVerifiedPublisher.md

@@ -33,12 +33,13 @@ Unset the verifiedPublisher previously set on an application, removing all verif
 For more information, see Publisher verification.
 
 ## EXAMPLES
-
-### EXAMPLE 1
+### Example 1: Using the Clear-MgApplicationVerifiedPublisher Cmdlet
 ```powershell
 Import-Module Microsoft.Graph.Applications
 Clear-MgApplicationVerifiedPublisher -ApplicationId $applicationId
 ```
+This example shows how to use the Clear-MgApplicationVerifiedPublisher Cmdlet.
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
 
 ## PARAMETERS
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Confirm-MgApplicationMemberGroup.md

@@ -33,12 +33,46 @@ Unset the verifiedPublisher previously set on an application, removing all verif
 For more information, see Publisher verification.
 
 ## EXAMPLES
+### Example 1: Check group memberships for a directory object
 
-### EXAMPLE 1
 ```powershell
-Import-Module Microsoft.Graph.Applications
-Clear-MgApplicationVerifiedPublisher -ApplicationId $applicationId
+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 shows how to use the Confirm-MgApplicationMemberGroup Cmdlet.
+
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+
+### Example 2: Check group memberships for the signed-in user
+
+```powershell
+Import-Module Microsoft.Graph.Users.Actions
+
+$params = @{
+	GroupIds = @(
+		"fee2c45b-915a-4a64b130f4eb9e75525e"
+		"4fe90ae065a-478b9400e0a0e1cbd540"
+	)
+}
+
+# A UPN can also be used as -UserId.
+Confirm-MgUserMemberGroup -UserId $userId -BodyParameter $params
+```
+This example shows how to use the Confirm-MgApplicationMemberGroup Cmdlet.
+
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+
 
 ## PARAMETERS
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Confirm-MgServicePrincipalMemberGroup.md

@@ -45,20 +45,46 @@ Confirm-MgApplicationMemberObject -InputObject <IApplicationsIdentity>
 Invoke action checkMemberObjects
 
 ## EXAMPLES
+### Example 1: Check group memberships for a directory object
 
-### EXAMPLE 1
 ```powershell
-{{ Add code here }}
+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 shows how to use the Confirm-MgServicePrincipalMemberGroup Cmdlet.
+
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
 
-{{ Add output here }}
+### Example 2: Check group memberships for the signed-in user
 
-### EXAMPLE 2
 ```powershell
-{{ Add code here }}
+Import-Module Microsoft.Graph.Users.Actions
+
+$params = @{
+	GroupIds = @(
+		"fee2c45b-915a-4a64b130f4eb9e75525e"
+		"4fe90ae065a-478b9400e0a0e1cbd540"
+	)
+}
+
+# A UPN can also be used as -UserId.
+Confirm-MgUserMemberGroup -UserId $userId -BodyParameter $params
 ```
+This example shows how to use the Confirm-MgServicePrincipalMemberGroup Cmdlet.
+
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
 
-{{ Add output here }}
 
 ## PARAMETERS
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Get-MgApplication.md

@@ -38,37 +38,50 @@ Get-MgApplication -InputObject <IApplicationsIdentity> [-ExpandProperty <String[
 Get the properties and relationships of an application object.
 
 ## EXAMPLES
+### Example 1: Get a list of applications
 
-### EXAMPLE 1
 ```powershell
 Connect-MgGraph -Scopes 'Application.Read.All'
 Get-MgApplication | 
   Format-List Id, DisplayName, AppId, SignInAudience, PublisherDomain
-```
 
 Id              : 8ea936e0-cb74-46c0-8408-d4614a596267
 DisplayName     : Test App
 AppId           : 39b09640-ec3e-44c9-b3de-f52db4e1cf66
 SignInAudience  : AzureADandPersonalMicrosoftAccount
 PublisherDomain : Contoso.com
+```
+
+This examples gets a list of all the applications.
+
+To learn about other permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+
+To consent to any of these permissions run `Connect-MgGraph -Scopes Permission`. For example, `Connect-MgGraph -Scopes Application.Read.All, Application.ReadWrite.All`.
+
+### Example 2: Get an application by Id
 
-### EXAMPLE 2
 ```powershell
 Connect-MgGraph -Scopes 'Application.Read.All'
 Get-MgApplication -Filter "AppId eq '39b09640-ec3e-44c9-b3de-f52db4e1cf66'" | 
   Format-List Id, DisplayName, AppId, SignInAudience, PublisherDomain
-```
 
 DisplayName     : Test App
 AppId           : 39b09640-ec3e-44c9-b3de-f52db4e1cf66
 SignInAudience  : AzureADandPersonalMicrosoftAccount
 PublisherDomain : Contoso.com
+```
+
+This examples gets the application by the specified Id.
+
+To learn about other permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+
+To consent to any of these permissions run `Connect-MgGraph -Scopes Permission`. For example, `Connect-MgGraph -Scopes Application.Read.All, Application.ReadWrite.All`.
+
+### Example 3: Get a count of all applications
 
-### EXAMPLE 3
 ```powershell
 Connect-MgGraph -Scopes 'Application.Read.All'
 Get-MgApplication -ConsistencyLevel eventual -Count appCount
-```
 
 Id                                   DisplayName        AppId                                SignInAudience                     PublisherDomain
 --                                   -----------        -----                                --------------                     ---------------
@@ -77,28 +90,49 @@ bce20771-2a69-41e5-a0dd-125ac2fa2708 Example 3 App      ffdf268a-2fe2-49e1-8cd7-
 dcaa0c3a-8dfa-4b47-bc04-0edbab42043a Principal-Test App bd38ad43-6c46-4cc6-b65c-a0db533a2a6f AzureADMyOrg                       Contoso.com
 f6b30057-7095-4e2c-89f8-224149f591b7 Testing App        00e80963-9bc0-4147-b9e0-2ba56093e7e6 AzureADandPersonalMicrosoftAccount Contoso.com
 fe4caed6-6182-4aca-b70b-b114c5334a8a New app            641992e9-d176-4aff-a3b6-a867b3ba48c4 AzureADandPersonalMicrosoftAccount Contoso.com
+```
+
+This example gets a list of all applications. The $appCount variable contains the count of the objects in the result. Advanced query requires the ConsistencyLevel parameter set to `eventual` and the Count parameter in the command. For more information about *ConsistencyLevel* and *Count*, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+
+To learn about other permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+
+To consent to any of these permissions run `Connect-MgGraph -Scopes Permission`. For example, `Connect-MgGraph -Scopes Application.Read.All, Application.ReadWrite.All`.
+
+### Example 4: Use -Search to get all the applications whose display name contains 'Test' including a count of the returned applications
 
-### EXAMPLE 4
 ```powershell
 Connect-MgGraph -Scopes 'Application.Read.All'
 Get-MgApplication -ConsistencyLevel eventual -Count appCount -Search '"DisplayName:Test"'
-```
 
 Id                                   DisplayName        AppId                                SignInAudience                     PublisherDomain
 --                                   -----------        -----                                --------------                     ---------------
 dcaa0c3a-8dfa-4b47-bc04-0edbab42043a Principal-Test App bd38ad43-6c46-4cc6-b65c-a0db533a2a6f AzureADMyOrg                       Contoso.com
 f6b30057-7095-4e2c-89f8-224149f591b7 Testing App        00e80963-9bc0-4147-b9e0-2ba56093e7e6 AzureADandPersonalMicrosoftAccount Contoso.com
+```
+
+This example returns all applications whose display name contains 'Test'. The $appCount variable contains the count of the objects in the result. Advanced query requires the ConsistencyLevel parameter set to `eventual` and the Count parameter in the command. For more information about *ConsistencyLevel* and *Count*, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+
+To learn about other permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+
+To consent to any of these permissions run `Connect-MgGraph -Scopes Permission`. For example, `Connect-MgGraph -Scopes Application.Read.All, Application.ReadWrite.All`.
+
+### Example 5: Use -Filter to get all the applications with a display name that starts with 'New' including a count of the returned applications, with the results ordered by display name
 
-### EXAMPLE 5
 ```powershell
 Connect-MgGraph -Scopes 'Application.Read.All'
 Get-MgApplication -ConsistencyLevel eventual -Count appCount -Filter "startsWith(DisplayName, 'New')" -OrderBy DisplayName
-```
 
 Id                                   DisplayName AppId                                SignInAudience                     PublisherDomain
 --                                   ----------- -----                                --------------                     ---------------
 fe4caed6-6182-4aca-b70b-b114c5334a8a New app     641992e9-d176-4aff-a3b6-a867b3ba48c4 AzureADandPersonalMicrosoftAccount Contoso.com
 0672d487-4c0c-475a-bf22-0e714f015597 New apps    ced14895-14ac-4dcf-8b93-0779f60c000d AzureADandPersonalMicrosoftAccount Contoso.com
+```
+
+This example returns all applications whose display name starts with 'New'. The $appCount variable contains the count of the objects in the result. Advanced query requires the ConsistencyLevel parameter set to `eventual` and the Count parameter in the command. For more information about *ConsistencyLevel* and *Count*, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+
+To learn about other permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+
+To consent to any of these permissions run `Connect-MgGraph -Scopes Permission`. For example, `Connect-MgGraph -Scopes Application.Read.All, Application.ReadWrite.All`.
 
 ## PARAMETERS
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Applications/Get-MgApplicationById.md

@@ -34,11 +34,10 @@ Return the directory objects specified in a list of IDs.
 Some common uses for this function are to:
 
 ## EXAMPLES
+### Example 1: Code snippet
 
-### EXAMPLE 1
 ```powershell
 Import-Module Microsoft.Graph.DirectoryObjects
-```
 
 $params = @{
 	Ids = @(
@@ -55,6 +54,11 @@ $params = @{
 }
 
 Get-MgDirectoryObjectById -BodyParameter $params
+```
+This example shows how to use the Get-MgApplicationById Cmdlet.
+
+To learn about permissions for this resource, see the [permissions reference](/graph/permissions-reference).
+
 
 ## PARAMETERS