Skip to content

Commit 824eb20

Browse files
committed
Freshness for Find-MgGraphCommand and Find-MgGraphPermission cmdlets
1 parent d54bf7a commit 824eb20

File tree

2 files changed

+20
-11
lines changed

2 files changed

+20
-11
lines changed

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

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Using Find-MgGraphCommand cmdlet"
33
description: "Learn how to use the Find-MgGraphCommand to aid in discoverability of cmdlets."
44

55
ms.topic: how-to
6-
ms.date: 01/15/2024
6+
ms.date: 01/22/2025
77
author: msewaweru
88
manager: CelesteDG
99
ms.author: eunicewaweru
@@ -14,17 +14,17 @@ reviewer: maisarissi
1414

1515
# Using Find-MgGraphCommand cmdlet
1616

17-
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.
17+
`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.
1818

19-
The Find-MgGraphCommand allows to:
19+
The `Find-MgGraphCommand` cmdlet allows you to:
2020

2121
- Pass a Microsoft Graph URL (relative and absolute) and get an equivalent Microsoft Graph PowerShell command.
2222
- Pass a command and get the URL it calls.
2323
- Pass a command or URI wildcard (.*) to find all commands that match it.
2424

2525
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.
2626

27-
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.
27+
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.
2828

2929
## Find Microsoft Graph PowerShell commands by URI
3030

@@ -62,8 +62,8 @@ Update-MgUser Users PATCH /users/{user-id} {DeviceManageme
6262
```
6363

6464
>[!Note]
65-
>1. For **-ApiVersion** parameter, there are two possible values: `v1.0` and `Beta`.
66-
>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.
65+
>1. For **-ApiVersion** parameter, there are two possible values: `v1.0` and `beta`.
66+
>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.
6767
>1. The output shown in this article has been shortened for readability.
6868
6969
## Find Microsoft Graph PowerShell commands by command name
@@ -172,3 +172,7 @@ Get-MgUserActivity CrossDeviceExperiences GET /users
172172
Get-MgUserActivity CrossDeviceExperiences GET /users/{user-id}/activities
173173
Get-MgUserActivityHistoryItem CrossDeviceExperiences GET /users/{user-id}/activities/{userActivity-id}/historyItems/{activityHistoryItem-id}
174174
```
175+
176+
## See also
177+
178+
- [Using Find-MgGraphPermission cmdlet](find-mg-graph-permission.md)

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

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Using Find-MgGraphPermission cmdlet"
33
description: "Learn how to use the Find-MgGraphPermission to discover permissions related to a ___domain."
44

55
ms.topic: how-to
6-
ms.date: 01/31/2024
6+
ms.date: 01/22/2025
77
author: msewaweru
88
manager: CelesteDG
99
ms.author: eunicewaweru
@@ -14,12 +14,13 @@ reviewer: maisarissi
1414

1515
# Using Find-MgGraphPermission cmdlet
1616

17-
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:
17+
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:
1818

19-
- 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?
20-
- 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.
19+
- 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?
20+
- What permissions are applicable to a certain ___domain? For example, application.
21+
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.
2122

22-
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.
23+
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.
2324

2425
## Find permissions related to a given ___domain
2526

@@ -72,3 +73,7 @@ Consent : Admin
7273
Name : Application.Read.All
7374
Description : Allows the app to read all applications and service principals without a signed-in user.
7475
```
76+
77+
## See also
78+
79+
- [Using Find-MgGraphCommand cmdlet](find-mg-graph-command.md)

0 commit comments

Comments
 (0)