Merge pull request #646 from MicrosoftDocs/main

Changes from main to live

Author: timayabi2020

.openpublishing.redirection.json

@@ -2,7 +2,22 @@
     "redirections": [
         {
             "source_path": "microsoftgraph/graph-powershell-1.0/Microsoft.Graph.Calendar/Get-MgPlace.md",
-            "redirect_url": "https://learn.microsoft.com/en-us/powershell/microsoftgraph/?view=graph-powershell-1.0",
+            "redirect_url": "https://learn.microsoft.com//powershell/microsoftgraph/",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "microsoftgraph/docs-conceptual/tutorial-grant-delegated-api-permissions.md",
+            "redirect_url": "https://learn.microsoft.com/powershell/microsoftgraph/how-to-grant-revoke-api-permissions&pivots=grant-delegated-permissions",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "microsoftgraph/docs-conceptual/tutorial-grant-app-only-api-permissions.md",
+            "redirect_url": "https://learn.microsoft.com/powershell/microsoftgraph/how-to-grant-revoke-api-permissions&pivots=grant-application-permissions",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "microsoftgraph/docs-conceptual/tutorial-pim.md",
+            "redirect_url": "https://learn.microsoft.com/powershell/microsoftgraph/how-to-assign-microsoft-entra-roles-in-pim",
             "redirect_document_id": false
         }
     ]

azure-pipelines/powershell-docs.yml

@@ -32,7 +32,7 @@ variables:
 extends:
   template: v1/1ES.Official.PipelineTemplate.yml@1ESPipelineTemplates
   parameters:
-    pool:
+    pool: 
       name: Azure-Pipelines-1ESPT-ExDShared
       image: windows-2022
       os: windows
@@ -108,13 +108,21 @@ extends:
             targetType: 'filePath'
             pwsh: true
             filePath: scripts/MsSubserviceUpdate.ps1
+        - task: PowerShell@2
+          displayName: 'Generate permissions table'
+          continueOnError: false
+          inputs:
+            targetType: 'filePath'
+            pwsh: true
+            filePath: scripts/GeneratePermissionsTable.ps1
         - task: PowerShell@2
           displayName: 'Update Links'
           continueOnError: false
           inputs:
             targetType: 'filePath'
             pwsh: true
             filePath: scripts/UpdateLinks.ps1
+            errorActionPreference: 'stop'
         - task: PowerShell@2
           displayName: 'Repair Examples and Descriptions and Title'
           continueOnError: false

microsoftgraph/docs-conceptual/find-mg-graph-command.md

@@ -3,7 +3,7 @@ title: "Using Find-MgGraphCommand cmdlet"
 description: "Learn how to use the Find-MgGraphCommand to aid in discoverability of cmdlets."
 
 ms.topic: how-to
-ms.date: 01/15/2024
+ms.date: 01/22/2025
 author: msewaweru
 manager: CelesteDG
 ms.author: eunicewaweru
@@ -14,17 +14,17 @@ reviewer: maisarissi
 
 # Using Find-MgGraphCommand cmdlet
 
-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:
+The `Find-MgGraphCommand` cmdlet allows you 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.
 
 The output of this cmdlet also includes the permissions required to authenticate the specified cmdlet. For more information on cmdlet permissions, see  [Using Find-MgGraphPermission](find-mg-graph-permission.md). Not all cmdlets have the permissions available on running this command. This is an ongoing feature, and permissions will continue to be added.
 
-The permissions displayed don't show the privilege levels. To learn more, including how to choose permissions, permission type and what is the most privileged/least privileged permission, use the corresponding API page doc.
+The permissions displayed don't show the privilege levels. To learn more, including how to choose permissions, permission type, and what is the most privileged/least privileged permission, use the corresponding API page doc.
 
 ## Find Microsoft Graph PowerShell commands by URI
 
@@ -62,8 +62,8 @@ Update-MgUser Users  PATCH  /users/{user-id}                     {DeviceManageme
 ```
 
 >[!Note]
->1. For **-ApiVersion** parameter, there are two possible values: `v1.0` and `Beta`.
->1. The **-Method** parameter is only available when using URI to find commands and allows the HTTPs methods such as GET, POST, PUT, PATCH and DELETE.
+>1. For **-ApiVersion** parameter, there are two possible values: `v1.0` and `beta`.
+>1. The **-Method** parameter is only available when using URI to find commands and allows the HTTPs methods such as GET, POST, PUT, PATCH, and DELETE.
 >1. The output shown in this article has been shortened for readability.
 
 ## Find Microsoft Graph PowerShell commands by command name
@@ -172,3 +172,7 @@ Get-MgUserActivity                    CrossDeviceExperiences       GET    /users
 Get-MgUserActivity                    CrossDeviceExperiences       GET    /users/{user-id}/activities
 Get-MgUserActivityHistoryItem         CrossDeviceExperiences       GET    /users/{user-id}/activities/{userActivity-id}/historyItems/{activityHistoryItem-id}
 ```
+
+## See also
+
+- [Using Find-MgGraphPermission cmdlet](find-mg-graph-permission.md)

microsoftgraph/docs-conceptual/find-mg-graph-permission.md

@@ -3,7 +3,7 @@ title: "Using Find-MgGraphPermission cmdlet"
 description: "Learn how to use the Find-MgGraphPermission to discover permissions related to a ___domain."
 
 ms.topic: how-to
-ms.date: 01/31/2024
+ms.date: 01/22/2025
 author: msewaweru
 manager: CelesteDG
 ms.author: eunicewaweru
@@ -14,12 +14,13 @@ reviewer: maisarissi
 
 # Using Find-MgGraphPermission cmdlet
 
-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:
+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. The `Find-MgGraphPermission` 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 a Microsoft Entra application using the `Connect-MgGraph` command. Use the [Find-MgGraphCommand](find-mg-graph-command.md) to find which permissions to use for a specific cmdlet or API.
+- 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.
+To use Microsoft Graph PowerShell to access Microsoft Graph, users must sign in to a Microsoft Entra application using the `Connect-MgGraph` command. Use the [Find-MgGraphCommand](find-mg-graph-command.md) to find which permissions to use for a specific cmdlet or API.
 
-Currently, PowerShell commands and scripts have no way of validating user input that refers to permissions or providing an ‘auto-complete’ user experience to help users accurately supply input to commands. This also affects commands or scripts implemented with the Microsoft Graph PowerShell SDK itself.
+Currently, PowerShell commands and scripts have no way of validating user input that refers to permissions or providing an *auto-complete* user experience to help users accurately supply input to commands. This also affects commands or scripts implemented with the Microsoft Graph PowerShell SDK itself.
 
 ## Find permissions related to a given ___domain
 
@@ -72,3 +73,7 @@ Consent        : Admin
 Name           : Application.Read.All
 Description    : Allows the app to read all applications and service principals without a signed-in user.
 ```
+
+## See also
+
+- [Using Find-MgGraphCommand cmdlet](find-mg-graph-command.md)

microsoftgraph/docs-conceptual/tutorial-pim.md renamed to microsoftgraph/docs-conceptual/how-to-assign-microsoft-entra-roles-in-pim.md

@@ -2,8 +2,8 @@
 title: "Assign Microsoft Entra roles in Privileged Identity Management using Microsoft Graph PowerShell"
 description: "Learn how to create eligible and active role assignments in Microsoft Entra Privileged Identity Management using Microsoft Graph PowerShell"
 
-ms.topic: tutorial
-ms.date: 01/31/2024
+ms.topic: how-to
+ms.date: 01/28/2025
 author: msewaweru
 manager: CelesteDG
 ms.author: eunicewaweru
@@ -12,21 +12,21 @@ ms.reviewer: mandardalvi
 #customer intent: As an IT administrator using Microsoft Entra ID, I want to assign and manage admin roles in Privileged Identity Management using Microsoft Graph PowerShell, so that I can control and monitor access to privileged roles in my organization.
 ---
 
-# Tutorial: Assign Microsoft Entra roles in Privileged Identity Management using Microsoft Graph PowerShell
+# Assign Microsoft Entra roles in Privileged Identity Management using Microsoft Graph PowerShell
 
 The Microsoft Entra Privileged Identity Management (PIM) service allows role administrators to make time-bound admin role assignments. Additionally, privileged role administrators can make users eligible for Microsoft Entra admin roles. An eligible administrator can activate the role when they need the role, and the permissions expire once the eligible administrator is done.
 
-In this tutorial, you'll create, extend, activate, deactivate, and remove eligible role assignments.
+In this article, you create, extend, activate, deactivate, and remove eligible role assignments.
 
 ## Prerequisites
 
-To successfully complete this tutorial, make sure you have the required prerequisites:
+To successfully complete this guide, make sure you have the required prerequisites:
 
 1. Microsoft Graph PowerShell SDK is installed. Follow the [Install the Microsoft Graph PowerShell SDK](installation.md) guide to install the SDK.  
 1. To use the Microsoft Entra Privileged Identity Management, you must have one of the following licenses:
     - Microsoft Entra ID P2
     - Enterprise Mobility + Security (EMS) E5 license
-1. Microsoft Graph PowerShell using a Privileged Role Administrator role and the appropriate permissions. For this tutorial, the `RoleManagement.ReadWrite.Directory` delegated permission is required. To set the permissions in Microsoft Graph PowerShell, run;
+1. Microsoft Graph PowerShell using a [Privileged Role Administrator](/entra/identity/role-based-access-control/permissions-reference#privileged-role-administrator) role and the appropriate permissions. For this guide, the `RoleManagement.ReadWrite.Directory` delegated permission is required. To set the permissions in Microsoft Graph PowerShell, run;
 
     ```powershell
     Connect-MgGraph -Scopes "RoleManagement.ReadWrite.Directory"
@@ -36,7 +36,7 @@ To successfully complete this tutorial, make sure you have the required prerequi
 
 ## Step 1: Create a user account
 
-In this step, you'll create a user who will be the target of the admin assignments. When you make these calls, change `contoso.onmicrosoft.com` to the ___domain name of your tenant. You can find tenant information on the Microsoft Entra overview page.
+In this step, you create a user who is the target of the admin assignments. When you make these calls, change `contoso.onmicrosoft.com` to the ___domain name of your tenant. You can find tenant information on the Microsoft Entra overview page.
 
 ```powershell
 $passwordProfile =@{
@@ -176,7 +176,7 @@ There are two ways to create active role assignments:
 - An admin can directly create an active role assignment for a user without first creating an eligible role assignment.
 - A user can activate an existing eligible role assignment.
 
-In this step, you'll activate the eligible role assignment created in step 2. To complete this step, sign in to the terminal as the user we created in step 1.
+In this step, you activate the eligible role assignment created in step 2. To complete this step, sign in to the terminal as the user we created in step 1.
 
 ```powershell
 $params = @{