Docs improvement for 0.15.0 preview release batch two (#1040)

Author: SteveMutungi254

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaApplicationServiceEndpoint.md

@@ -34,8 +34,9 @@ Get-EntraBetaApplicationServiceEndpoint
 ## Description
 
 The `Get-EntraBetaApplicationServiceEndpoint` cmdlet retrieves the service endpoint(s) of an application.
-The service endpoint entity contains service discovery information.
-The serviceEndpoints property of the Application entity is of type ServiceEndpoint.
+
+The service endpoint entity contains service discovery information. The serviceEndpoints property of the Application entity is of type ServiceEndpoint.
+
 Other services can use the information stored in the ServiceEndpoint entity to find this service and its addressable endpoints.
 
 ## Examples
@@ -44,30 +45,36 @@ Other services can use the information stored in the ServiceEndpoint entity to f
 
 ```powershell
 Connect-Entra -Scopes 'Application.Read.All'
-Get-EntraBetaApplicationServiceEndpoint -ObjectId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
+$application = Get-EntraBetaApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
+Get-EntraBetaApplicationServiceEndpoint -ObjectId $application.ObjectId
 ```
 
 This example demonstrates how to retrieve service endpoint of the application that is specified through the Object ID parameter.
+
 `-ObjectId` parameter specifies the ID of an application object in Microsoft Entra ID.
 
 ### Example 2: Get all service endpoints
 
 ```powershell
 Connect-Entra -Scopes 'Application.Read.All'
-Get-EntraBetaApplicationServiceEndpoint -ObjectId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb' -All 
+$application = Get-EntraBetaApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
+Get-EntraBetaApplicationServiceEndpoint -ObjectId $application.ObjectId -All 
 ```
 
 This example demonstrates how to retrieve all service endpoints of a specified application.
+
 `-ObjectId` parameter specifies the ID of an application object in Microsoft Entra ID.
 
 ### Example 3: Get top five service endpoints
 
 ```powershell
 Connect-Entra -Scopes 'Application.Read.All'
-Get-EntraBetaApplicationServiceEndpoint -ObjectId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb' -Top 5
+$application = Get-EntraBetaApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
+Get-EntraBetaApplicationServiceEndpoint -ObjectId $application.ObjectId -Top 5
 ```
 
 This example demonstrates how to retrieve five service endpoints of a specified application.
+
 `-ObjectId` parameter specifies the ID of an application object in Microsoft Entra ID.
 
 ## Parameters
@@ -154,3 +161,5 @@ System.Nullable\`1\[\[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral
 ## Notes
 
 ## Related Links
+
+[Get-EntraBetaApplication](Get-EntraBetaApplication.md)

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaApplicationTemplate.md

@@ -48,7 +48,7 @@ The `Get-EntraBetaApplicationTemplate` cmdlet allows users to get a list of all
 
 ## Examples
 
-### 1. Gets a list of application template objects
+### Example 1. Gets a list of application template objects
 
 ```powershell
 Connect-Entra -Scopes 'Application.Read.All'
@@ -57,7 +57,7 @@ Get-EntraBetaApplicationTemplate
 
 This command gets all the application template objects
 
-### 2. Gets an application template object
+### Example 2. Gets an application template object
 
 ```powershell
 Connect-Entra -Scopes 'Application.Read.All'

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaAttributeSet.md

@@ -42,7 +42,16 @@ Get-EntraBetaAttributeSet
 
 ## Description
 
-Gets a list of Microsoft Entra ID attribute sets. Specify `Id` parameter to retrieve an attribute set.
+The `Get-EntraABetaAttributeSet` cmdlet gets a list of Microsoft Entra ID attribute sets.
+
+In delegated scenarios with work or school accounts, the signed-in user must have a supported Microsoft Entra role or a custom role with the necessary permissions. The supported roles for this operation are:
+
+- Attribute Assignment Reader
+- Attribute Definition Reader
+- Attribute Assignment Administrator
+- Attribute Definition Administrator
+
+By default, other administrator roles cannot read, define, or assign custom security attributes.
 
 ## Examples
 
@@ -83,7 +92,9 @@ This example demonstrates how to retrieve an attribute set by Id.
 
 ### -Id
 
-Unique identifier for the attribute set within a tenant. This identifier can be up to 32 characters long and may include Unicode characters. It cannot contain spaces or special characters, and it cannot be changed later. The identifier is case insensitive.
+Unique identifier for the attribute set within a tenant. 
+
+This identifier can be up to 32 characters long and may include Unicode characters. It cannot contain spaces or special characters, and it cannot be changed later. The identifier is case insensitive.
 
 ```yaml
 Type: System.String

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaAuditDirectoryLogs.md

@@ -37,6 +37,7 @@ Get-EntraBetaAuditDirectoryLogs
 ## Description
 
 The `Get-EntraBetaAuditDirectoryLogs` cmdlet gets a Microsoft Entra ID audit log.
+
 Retrieve audit logs from Microsoft Entra ID, covering logs from various services such as user, app, device, and group management, privileged identity management (PIM), access reviews, terms of use, identity protection, password management (SSPR and admin resets), and self-service group management.
 
 ## Examples
@@ -81,7 +82,6 @@ This example returns the first N logs.
 
 ```powershell
 Connect-Entra -Scopes 'AuditLog.Read.All, Directory.Read.All'
-Get-EntraBetaAuditDirectoryLogs -Filter "ActivityDisplayName eq 'Update rollout policy of feature'" 
 Get-EntraBetaAuditDirectoryLogs -Filter "ActivityDisplayName eq 'Update rollout policy of feature'" -Top 1
 ```
 
@@ -97,7 +97,6 @@ This command shows how to get audit logs by ActivityDisplayName.
 
 ```powershell
 Connect-Entra -Scopes 'AuditLog.Read.All, Directory.Read.All'
-Get-EntraBetaAuditDirectoryLogs -Filter "result eq 'success'"
 Get-EntraBetaAuditDirectoryLogs -Filter "result eq 'failure'" -All
 ```
 
@@ -110,7 +109,7 @@ This command shows how to get audit logs by the result.
 List all pages.
 
 ```yaml
-Type:  System.Management.Automation.SwitchParameter
+Type: System.Management.Automation.SwitchParameter
 Parameter Sets: (All)
 Aliases:
 

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaAuditSignInLogs.md

@@ -85,7 +85,6 @@ This example returns the first two audit logs of sign-ins.
 
 ```powershell
 Connect-Entra -Scopes 'AuditLog.Read.All','Directory.Read.All'
-Get-EntraBetaAuditSignInLogs -Filter "AppDisplayName eq 'Graph Explorer'" 
 Get-EntraBetaAuditSignInLogs -Filter "AppDisplayName eq 'Graph Explorer'" -Top 1
 ```
 

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaAuthorizationPolicy.md

@@ -46,7 +46,14 @@ The `Get-EntraBetaAuthorizationPolicy` cmdlet gets a Microsoft Entra ID authoriz
 
 ## Examples
 
-### Example 1: Get an authorization policy by ID
+### Example 1: Get all policies
+
+```powershell
+Connect-Entra -Scopes 'Policy.Read.All'
+Get-EntraBetaAuthorizationPolicy
+```
+
+### Example 2: Get an authorization policy by ID
 
 ```powershell
 Connect-Entra -Scopes 'Policy.Read.All'

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaContact.md

@@ -50,7 +50,7 @@ The `Get-EntraBetaContact` cmdlet gets a contact from Microsoft Entra ID.
 
 ## Examples
 
-### Example 1 Retrieve all contact objects in the directory
+### Example 1: Retrieve all contact objects in the directory
 
 ```powershell
 Connect-Entra -Scopes 'OrgContact.Read.All'

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaContactDirectReport.md

@@ -47,15 +47,17 @@ $Contact = Get-EntraBetaContact -Top 1
 Get-EntraBetaContactDirectReport -ObjectId $Contact.ObjectId
 ```
 
-This example shows how to retrieve direct reports for an organizational contact. You can use the command `Get-EntraBetaContact` to get organizational contact.
+This example shows how to retrieve direct reports for an organizational contact.
+You can use the command `Get-EntraBetaContact` to get organizational contact.
 
 - `-ObjectId` parameter specifies the contact Id.
 
 ### Example 2: Get all direct reports of a contact
 
 ```powershell
 Connect-Entra -Scopes 'OrgContact.Read.All'
-Get-EntraBetaContactDirectReport -ObjectId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb' -All
+$Contact = Get-EntraBetaContact -Top 1
+Get-EntraBetaContactDirectReport -ObjectId $Contact.ObjectId -All
 ```
 
 This example shows how to retrieve all direct reports for an organizational contact.
@@ -66,7 +68,8 @@ This example shows how to retrieve all direct reports for an organizational cont
 
 ```powershell
 Connect-Entra -Scopes 'OrgContact.Read.All'
-Get-EntraBetaContactDirectReport -ObjectId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb' -Top 2
+$Contact = Get-EntraBetaContact -Top 1
+Get-EntraBetaContactDirectReport -ObjectId $Contact.ObjectId -Top 2
 ```
 
 This example shows how to retrieve top two direct reports for an organizational contact.

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaDeletedApplication.md

@@ -236,4 +236,4 @@ System.Nullable\`1\[\[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral
 
 ## Related Links
 
-[Get-EntraBetaApplication](Get-EntraBetaApplication.md)
+[Get-EntraBetaApplication](Get-EntraBetaApplication.md)

module/docs/entra-powershell-beta/Microsoft.Graph.Entra.Beta/Get-EntraBetaDeletedDirectoryObject.md

@@ -34,6 +34,7 @@ Get-EntraBetaDeletedDirectoryObject
 ## Description
 
 The `Get-EntraBetaDeletedDirectoryObject` cmdlet retrieves a soft deleted directory object from the directory.
+
 Note that soft delete for groups is currently only implemented for Unified Groups (also known as
 Office 365 Groups).