Merge pull request #700 from MicrosoftDocs/main

Merge main into Saisang-patch-1

Author: Saisang

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

@@ -8,8 +8,7 @@ schema: 2.0.0
 # Connect-MgGraph
 
 ## SYNOPSIS
-Microsoft Graph PowerShell supports two types of authentication: delegated and app-only access.
-There are a number of cmdlets that can be used to manage the different parameters required during authentication, for example, environment, application ID, and certificate.
+You must invoke Connect-MgGraph before any commands that access Microsoft Graph.
 
 ## SYNTAX
 
@@ -54,8 +53,12 @@ Connect-MgGraph [-ContextScope <ContextScope>] [-Environment <String>] [-ClientT
 ```
 
 ## DESCRIPTION
-You must invoke Connect-MgGraph before any commands that access Microsoft Graph.
-This cmdlet gets the access token using the Microsoft Authentication Library
+
+Microsoft Graph PowerShell supports two types of authentication: delegated and app-only access.
+There are a number of cmdlets that can be used to manage the different parameters required during
+authentication, for example, environment, application ID, and certificate.
+
+This cmdlet gets the access token using the Microsoft Authentication Library.
 
 ## EXAMPLES
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Authentication/Connect-MgGraph.md

@@ -8,8 +8,7 @@ schema: 2.0.0
 # Disconnect-MgGraph
 
 ## SYNOPSIS
-Once you're signed in, you'll remain signed in until you invoke Disconnect-MgGraph.
-Microsoft Graph PowerShell automatically refreshes the access token for you and sign-in persists across PowerShell sessions because Microsoft Graph PowerShell securely caches the token.
+Use Disconnect-MgGraph to sign out.
 
 ## SYNTAX
 
@@ -18,7 +17,10 @@ Disconnect-MgGraph [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-Use Disconnect-MgGraph to sign out.
+
+Once you're signed in, you'll remain signed in until you invoke Disconnect-MgGraph. Microsoft Graph
+PowerShell automatically refreshes the access token for you and sign-in persists across PowerShell
+sessions because Microsoft Graph PowerShell securely caches the token.
 
 ## EXAMPLES
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Authentication/Disconnect-MgGraph.md

@@ -8,38 +8,47 @@ schema: 2.0.0
 # Find-MgGraphCommand
 
 ## SYNOPSIS
-Find-MgGraphCommand aims to make it easier for you to discover which API path a command calls, by providing a URI or a command name.
-The Find-MgGraphCommand allows to:  - Pass a Microsoft Graph URL (relative and absolute) and get an equivalent Microsoft Graph PowerShell command.
-- Pass a command and get the URL it calls.
-- Pass a command or URI wildcard (.*) to find all commands that match it.
+Find-MgGraphCommand aims to make it easier for you to discover which API path a command calls, by
+providing a URI or a command name.
 
 ## SYNTAX
 
 ### FindByCommandOrUri (Default)
+
 ```
 Find-MgGraphCommand [-ApiVersion <String>] [-InputObject] <Object[]> [-ProgressAction <ActionPreference>]
  [<CommonParameters>]
 ```
 
 ### FindByUri
+
 ```
 Find-MgGraphCommand [-Uri] <String[]> [-Method <String>] [-ApiVersion <String>]
  [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ### FindByCommand
+
 ```
 Find-MgGraphCommand [-ApiVersion <String>] -Command <String[]> [-ProgressAction <ActionPreference>]
  [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-Find-MgGraphCommand aims to make it easier for you to discover which API path a command calls, by providing a URI or a command name.
+
+Find-MgGraphCommand aims to make it easier for you to discover which API path a command calls, by
+providing a URI or a command name. The Find-MgGraphCommand allows to:
+
+- Pass a Microsoft Graph URL (relative and absolute) and get an equivalent Microsoft Graph
+  PowerShell command.
+- Pass a command and get the URL it calls.
+- Pass a command or URI wildcard (.*) to find all commands that match it.
 
 ## EXAMPLES
 
 ### Example 1: Use a URI to get all related cmdlets
-```
+
+```powershell
 PS C:\> Find-MgGraphCommand -Uri "/users/{id}"
 
  APIVersion: v1.0
@@ -63,7 +72,8 @@ Update-MgUser Users  PATCH  /users/{user-id}                     {DeviceManageme
 This example finds all commands that call the provided Microsoft Graph URI.
 
 ### Example 2: Pass a command and get the URI it calls
-```
+
+```powershell
 PS C:\> Find-MgGraphCommand -Command 'Get-MgUser'
 
 APIVersion: v1.0
@@ -85,7 +95,8 @@ Get-MgUser Users  GET    /users           IMicrosoftGraphUser {DeviceManagementA
 This example looks up a command with the provided command name that calls both beta and v1.0 version of the API.
 
 ### Example 3: Pass a command and get the permissions required
-```
+
+```powershell
 PS C:\> Find-MgGraphCommand -command Get-MgUser | Select -First 1 -ExpandProperty Permissions
 
 Name                                         IsAdmin Description                                   FullDescription
@@ -101,7 +112,8 @@ User.ReadWrite.All                           True    Read and write all users' f
 This example retrieves the scopes required for a particular command.
 
 ### Example 4: Find Microsoft Graph PowerShell commands using a command wildcard
-```
+
+```powershell
 PS C:\> Find-MgGraphCommand -Command .*UserToDo.* -APIVersion 'v1.0'
    APIVersion: v1.0
 
@@ -119,7 +131,8 @@ Get-MgUserTodoListTask                         Users           GET    /users/{us
 Uses a wildcard syntax to search for commands.
 
 ### Example 5: Find Microsoft Graph PowerShell commands using a URI wildcard
-```
+
+```powershell
 PS C:\> Find-MgGraphCommand -Uri ".*users.*" -Method 'Get' -ApiVersion 'v1.0'
 Command                               Module                       Method URI
 -------                               ------                       ------ ---
@@ -135,6 +148,7 @@ Searches for commands using URI wildcard.
 ## PARAMETERS
 
 ### -ApiVersion
+
 The service API version.
 
 ```yaml
@@ -150,8 +164,8 @@ Accept wildcard characters: False
 ```
 
 ### -Command
-The name of a command.
-e.g., Get-MgUser.}
+
+The name of a command. For example, `Get-MgUser`.
 
 ```yaml
 Type: String[]
@@ -166,6 +180,7 @@ Accept wildcard characters: False
 ```
 
 ### -InputObject
+
 Pipeline input object
 
 ```yaml
@@ -181,6 +196,7 @@ Accept wildcard characters: False
 ```
 
 ### -Method
+
 The HTTP method a command makes.
 
 ```yaml
@@ -196,6 +212,7 @@ Accept wildcard characters: False
 ```
 
 ### -ProgressAction
+
 Treat this as a common parameter.
 
 ```yaml
@@ -211,8 +228,8 @@ Accept wildcard characters: False
 ```
 
 ### -Uri
-The API path a command calls.
-e.g., /users.
+
+The API path a command calls. For example, `/users`.
 
 ```yaml
 Type: String[]
@@ -227,21 +244,33 @@ Accept wildcard characters: False
 ```
 
 ### CommonParameters
-This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
+-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
+-WarningAction, and -WarningVariable. For more information, see
+[about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
 
 ## INPUTS
 
-### Pipeline input accepts API URIs as an array of strings.
+### System.String[]
+
+Pipeline input accepts API URIs as an array of strings.
+
 ## OUTPUTS
 
-### Microsoft.Graph.PowerShell.Authentication.Models.IGraphCommand with the following properties:
-### 1. Command: Name of command.
-### 2. Module: Module in which a command is defined.
-### 3. Method: The HTTP method a command makes.
-### 4. Uri: The Microsoft Graph API URI a command calls.
-### 5. OutputType: The return type of a command.
-### 6. Permissions: Permissions needed to use a command. This field can be empty if the permissions are not yet available in Graph Explorer.
-### 7. Variants: The parameter sets of a command.
+### Microsoft.Graph.PowerShell.Authentication.Models.IGraphCommand
+
+The **IGraphCommand** class has the following properties:
+
+- **Command**: Name of command.
+- **Module**: Module in which a command is defined.
+- **Method**: The HTTP method a command makes.
+- **Uri**: The Microsoft Graph API URI a command calls.
+- **OutputType**: The return type of a command.
+- **Permissions**: Permissions needed to use a command. This field can be empty if the permissions
+  are not yet available in Graph Explorer.
+- **Variants**: The parameter sets of a command.
+
 ## NOTES
 
 ## RELATED LINKS

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Authentication/Find-MgGraphCommand.md

@@ -8,11 +8,7 @@ schema: 2.0.0
 # Find-MgGraphPermission
 
 ## SYNOPSIS
-The Microsoft Graph PowerShell SDK application requires users to have ___domain knowledge of both the semantics and syntax of Microsoft Graph API permissions used to authorize access to the API.
-This cmdlet helps to answer the following questions:  - How do I find the values to supply to the permission-related parameters of commands like New-MgApplication and other application and consent related commands?
-- What permissions are applicable to a certain ___domain, for example, application, directory?
-To use Microsoft Graph PowerShell SDK to access Microsoft Graph, users must sign in to an Azure AD application using the Connect-MgGraph command.
-Use the Find-MgGraphCommand to find which permissions to use for a specific cmdlet or API.-  Currently PowerShell commands and scripts, including those implemented with Microsoft Graph PowerShell SDK itself, have no way of validating user input that refers to permissions or providing "auto-complete" user experiences to help users accurately supply input to commands
+Retrieves permissions that are applicable to a certain ___domain.
 
 ## SYNTAX
 
@@ -29,8 +25,20 @@ Find-MgGraphPermission [-PermissionType <String>] [-Online] [-All] [-ProgressAct
 ```
 
 ## DESCRIPTION
-Retrieves permissions that are applicable to a certain ___domain.
-For example application, directory.
+
+The Microsoft Graph PowerShell SDK application requires users to have ___domain knowledge of both the
+semantics and syntax of Microsoft Graph API permissions used to authorize access to the API. This
+cmdlet helps to answer the following questions:
+
+- How do I find the values to supply to the permission-related parameters of commands like
+  New-MgApplication and other application and consent related commands?
+- What permissions are applicable to a certain ___domain, for example, application, directory? To use
+  Microsoft Graph PowerShell SDK to access Microsoft Graph, users must sign in to an Azure AD
+  application using the Connect-MgGraph command. Use the Find-MgGraphCommand to find which
+  permissions to use for a specific cmdlet or API.
+- Currently PowerShell commands and scripts, including those implemented with Microsoft Graph
+  PowerShell SDK itself, have no way of validating user input that refers to permissions or
+  providing "auto-complete" user experiences to help users accurately supply input to commands
 
 ## EXAMPLES
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Authentication/Find-MgGraphPermission.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Get-MgContext
 
 ## SYNOPSIS
-Get-MgContext is used to retrieve the details about your current session, which include:  - ClientID - TenantID - Certificate Thumbprint - Scopes consented to - AuthType: Delegated or app-only - AuthProviderType - CertificateName - Account - AppName - ContextScope - Certificate - PSHostVersion - ClientTimeOut.
+Retrieves session details.
 
 ## SYNTAX
 
@@ -17,7 +17,22 @@ Get-MgContext [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-Retrieves session details.
+
+Get-MgContext is used to retrieve the details about your current session, which include:
+
+- ClientID
+- TenantID
+- Certificate Thumbprint
+- Scopes consented to
+- AuthType: Delegated or app-only
+- AuthProviderType
+- CertificateName
+- Account
+- AppName
+- ContextScope
+- Certificate
+- PSHostVersion
+- ClientTimeout
 
 ## EXAMPLES
 

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Authentication/Get-MgContext.md

@@ -9,7 +9,6 @@ schema: 2.0.0
 
 ## SYNOPSIS
 Gets global configurations that apply to the SDK.
-For example, check if Web Account Manager (WAM) support has been enabled.
 
 ## SYNTAX
 
@@ -26,7 +25,7 @@ For example, check if Web Account Manager (WAM) support has been enabled.
 ### Example 1: Check if WAM support has been enabled
 ```
 PS C:\> Get-MgGraphOption
-EnableWAMForMSGraph 
+EnableWAMForMSGraph
 --------------------
                 True
 ```

microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Authentication/Get-MgGraphOption.md

@@ -8,9 +8,7 @@ schema: 2.0.0
 # Invoke-MgGraphRequest
 
 ## SYNOPSIS
-Invoke-MgGraphRequest issues REST API requests to the Graph API.
-It works for any Graph API if you know the REST URI, method, and optional body parameter.
-This command is especially useful for accessing APIs for which there isn't an equivalent cmdlet yet.
+This command issues REST API requests.
 
 ## SYNTAX
 
@@ -24,7 +22,9 @@ Invoke-MgGraphRequest [[-Method] <GraphRequestMethod>] [-Uri] <Uri> [[-Body] <Ob
 ```
 
 ## DESCRIPTION
-This command issues REST API requests.
+Invoke-MgGraphRequest issues REST API requests to the Graph API. It works for any Graph API if you
+know the REST URI, method, and optional body parameter. This command is especially useful for
+accessing APIs for which there isn't an equivalent cmdlet yet.
 
 ## EXAMPLES