Skip to content

Commit 9f797b1

Browse files
authored
Merge pull request MicrosoftDocs#206 from msewaweru/freshness-work
Minor edits to freshen up the articles
2 parents 8cddcfe + 7cdde9c commit 9f797b1

File tree

3 files changed

+24
-18
lines changed

3 files changed

+24
-18
lines changed

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

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,19 @@ 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/11/2022
6+
ms.date: 01/31/2023
77
author: msewaweru
88
manager: CelesteDG
99
ms.author: eunicewaweru
10+
reviewer: maisarissi
1011
---
1112

1213
# Using Find-MgGraphCommand cmdlet
1314

14-
Find-MgGraphCommand aims to make it easy for you to discover which API path a command calls by providing a URI or a command name.
15+
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.
16+
17+
The Find-MgGraphCommand allows to:
1518

16-
The Find-MgGraphCommand allows to;
1719
- Pass a Microsoft Graph URL (relative and absolute) and get an equivalent Microsoft Graph PowerShell command.
1820
- Pass a command and get the URL it calls.
1921
- Pass a command or URI wildcard (.*) to find all commands that match it.
@@ -58,8 +60,8 @@ Update-MgUser Users PATCH /users/{user-id} {DeviceManageme
5860
```
5961

6062
>[!Note]
61-
>1. For -ApiVersion parameter, there are two possible values: `v1.0` and `Beta`.
62-
>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.
63+
>1. For **-ApiVersion** parameter, there are two possible values: `v1.0` and `Beta`.
64+
>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.
6365
>1. The output shown in this article has been shortened for readability.
6466
6567
## Find Microsoft Graph PowerShell commands by command name
@@ -126,18 +128,21 @@ Find-MgGraphCommand -Command .*searchstring.* [-ApiVersion <String>] [<CommonPar
126128
#### Example 1: Search for commands using a command wildcard
127129

128130
```powershell
129-
Find-MgGraphCommand -Command .*TeamTag.* -APIVersion 'Beta'
131+
Find-MgGraphCommand -Command .*UserToDo.* -APIVersion 'v1.0'
130132
```
131133

132134
```Output
133-
APIVersion: beta
134-
135-
Command Module Method URI OutputType Permissions Variants
136-
------- ------ ------ --- ---------- ----------- --------
137-
Get-MgTeamTag Teams GET /teams/{team-id}/tags IMicrosoftGraphTeamworkTag {} {List}
138-
Get-MgTeamTag Teams GET /teams/{team-id}/tags/{teamworkTag-id} IMicrosoftGraphTeamworkTag {} {Get, GetViaIdentity}
139-
Get-MgTeamTagMember Teams GET /teams/{team-id}/tags/{teamworkTag-id}/members IMicrosoftGraphTeamworkTagMember {} {List}
140-
Get-MgTeamTagMember Teams GET /teams/{team-id}/tags/{teamworkTag-id}/members/{teamworkTagMember-id} IMicrosoftGraphTeamworkTagMember {} {Get, GetViaIdentity}
135+
APIVersion: v1.0
136+
137+
Command Module Method URI
138+
------- ------ ------ ---
139+
Get-MgUserTodoList Users GET /users/{user-id}/todo/lists
140+
Get-MgUserTodoList Users GET /users/{user-id}/todo/lists/{todoTaskList-id}
141+
Get-MgUserTodoListDelta Users.Functions GET /users/{user-id}/todo/lists/delta
142+
Get-MgUserTodoListExtension Users GET /users/{user-id}/todo/lists/{todoTaskList-id}/extensions
143+
Get-MgUserTodoListExtension Users GET /users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id}
144+
Get-MgUserTodoListTask Users GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks
145+
Get-MgUserTodoListTask Users GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}
141146
```
142147

143148
## Find Microsoft Graph PowerShell commands using a URI wildcard

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

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,20 +3,21 @@ 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/11/2022
6+
ms.date: 01/31/2023
77
author: msewaweru
88
manager: CelesteDG
99
ms.author: eunicewaweru
10+
reviewer: maisarissi
1011
---
1112

1213
# Using Find-MgGraphPermission cmdlet
1314

1415
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:
1516

1617
- 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?
17-
- 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 Active Directory 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.
18+
- 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](find-mg-graph-command.md) to find which permissions to use for a specific cmdlet or API.
1819

19-
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
20+
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
2021

2122
## Find permissions related to a given ___domain
2223

microsoftgraph/docs-conceptual/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
href: app-only.md
2323
- name: Manage access to resources
2424
href: tutorial-entitlement-management.md
25-
- name: Privilege Identity Management (PIM)
25+
- name: Privileged Identity Management (PIM)
2626
items:
2727
- name: Assign Azure AD roles in PIM
2828
href: tutorial-pim.md

0 commit comments

Comments
 (0)