Added synopsis, descriptions and examples for find-mggraphpermissions

Author: timayabi2020

src/Authentication/descriptions/Find-MgGraphPermission.md

@@ -0,0 +1 @@
+Retrieves permissions that are applicable to a certain domain. For example application, directory.

src/Authentication/examples/Find-MgGraphPermission.md

@@ -0,0 +1,45 @@
+### Example 1: Find permissions related to a given domain
+```powershell
+PS C:\> Find-MgGraphPermission application
+PermissionType: Delegated
+
+Id                                   Consent Name                                      Description
+--                                   ------- ----                                      -----------
+c79f8feb-a9db-4090-85f9-90d820caa0eb Admin   Application.Read.All                      Allows the app to read applications and service principals on behalf of the signed-in user.
+bdfbf15f-ee85-4955-8675-146e8e5296b5 Admin   Application.ReadWrite.All                 Allows the app to create, read, update and delete applications and service principals on behalf of the signed-in user. Does not allow management of consent grants.
+b27add92-efb2-4f16-84f5-8108ba77985c Admin   Policy.ReadWrite.ApplicationConfiguration Allows the app to read and write your organization's application configuration policies on behalf of the signed-in user.  This includes policies such as activityBasedTimeoutPolicy, claimsMappingPolicy, homeRealmDiscoveryPolicy,  tokenIssuancePolicy and tokenLifetimePolicy.
+
+
+   PermissionType: Application
+
+Id                                   Consent Name                                      Description
+--                                   ------- ----                                      -----------
+9a5d68dd-52b0-4cc2-bd40-abcf44ac3a30 Admin   Application.Read.All                      Allows the app to read all applications and service principals without a signed-in user.
+1bfefb4e-e0b5-418b-a88f-73c46d2cc8e9 Admin   Application.ReadWrite.All                 Allows the app to create, read, update and delete applications and service principals without a signed-in user.  Does not allow management of consent grants.
+18a4783c-866b-4cc7-a460-3d5e5662c884 Admin   Application.ReadWrite.OwnedBy             Allows the app to create other applications, and fully manage those applications (read, update, update application secrets and delete), without a signed-in user. Â It cannot update any apps that it is not an owner of.
+be74164b-cff1-491c-8741-e671cb536e13 Admin   Policy.ReadWrite.ApplicationConfiguration Allows the app to read and write your organization's application configuration policies, without a signed-in user.  This includes policies such as activityBasedTimeoutPolicy, claimsMappingPolicy, homeRealmDiscoveryPolicy, tokenIssuancePolicy  and tokenLifetimePolicy.
+```
+Retrieves permissions related to a given domain.
+
+### Example 2: Find the identifier for a specific permission
+```powershell
+PS C:\> Find-MgGraphPermission application.Read | Format-List
+Id             : c79f8feb-a9db-4090-85f9-90d820caa0eb
+PermissionType : Delegated
+Consent        : Admin
+Name           : Application.Read.All
+Description    : Allows the app to read applications and service principals on behalf of the signed-in user.
+
+Id             : bdfbf15f-ee85-4955-8675-146e8e5296b5
+PermissionType : Delegated
+Consent        : Admin
+Name           : Application.ReadWrite.All
+Description    : Allows the app to create, read, update and delete applications and service principals on behalf of the signed-in user. Does not allow management of consent grants.
+
+Id             : 9a5d68dd-52b0-4cc2-bd40-abcf44ac3a30
+PermissionType : Application
+Consent        : Admin
+Name           : Application.Read.All
+Description    : Allows the app to read all applications and service principals without a signed-in user.
+```
+Retrieves identifier for a specific permission.

src/Authentication/synopsis/Find-MgGraphPermission.md

@@ -0,0 +1,6 @@
+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