@pnp/cli-microsoft365 7.3.0-beta.4df0638 → 7.3.0-beta.66401a3

package/docs/docs/cmd/aad/administrativeunit/administrativeunit-member-get.mdx

@@ -0,0 +1,130 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# aad administrativeunit member get
+
+Retrieves info about a specific member of an administrative unit
+
+## Usage
+
+```sh
+m365 aad administrativeunit member get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: The id of a member to be retrieved.
+
+`-u, --administrativeUnitId [administrativeUnitId]`
+: The id of the administrative unit. Specify either `administrativeUnitId` or `administrativeUnitName`.
+
+`-n, --administrativeUnitName [administrativeUnitName]`
+: The name of the administrative unit. Specify either `administrativeUnitId` or `administrativeUnitName`.
+
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
+```
+
+<Global />
+
+## Remarks
+
+To get the member of a hidden membership in an administrative unit, the `Member.Read.Hidden` permission is required.
+
+When the `properties` option includes values with a `/`, for example: `manager/displayName`, an additional `$expand` query parameter will be included on manager.
+
+## Examples
+
+Get information about a member specified by id from an administrative unit specified by id
+
+```sh
+m365 aad administrativeunit member get --id 64131a70-beb9-4ccb-b590-4401e58446ec --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 
+```
+
+Get information about a member specified by id from an administrative unit specified by name
+
+```sh
+m365 aad administrativeunit member get --id 64131a70-beb9-4ccb-b590-4401e58446ec --administrativeUnitName 'Marketing Division' 
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "64131a70-beb9-4ccb-b590-4401e58446ec",
+    "businessPhones": [
+      "+20 255501070"
+    ],
+    "displayName": "Pradeep Gupta",
+    "givenName": "Pradeep",
+    "jobTitle": "Accountant",
+    "mail": "PradeepG@contoso.com",
+    "mobilePhone": null,
+    "officeLocation": "98/2202",
+    "preferredLanguage": "en-US",
+    "surname": "Gupta",
+    "userPrincipalName": "PradeepG@contoso.com",
+    "type": "user"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  businessPhones   : ["+20 255501070"]
+  displayName      : Pradeep Gupta
+  givenName        : Pradeep
+  id               : 64131a70-beb9-4ccb-b590-4401e58446ec
+  jobTitle         : Accountant
+  mail             : PradeepG@contoso.com
+  mobilePhone      : null
+  officeLocation   : 98/2202
+  preferredLanguage: en-US
+  surname          : Gupta
+  type             : user
+  userPrincipalName: PradeepG@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,givenName,jobTitle,mail,officeLocation,preferredLanguage,surname,userPrincipalName,type
+  64131a70-beb9-4ccb-b590-4401e58446ec,Pradeep Gupta,Pradeep,Accountant,PradeepG@contoso.com,98/2202,en-US,Gupta,PradeepG@contoso.com,user
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Date: 11/10/2023
+
+  ## Pradeep Gupta (64131a70-beb9-4ccb-b590-4401e58446ec)
+
+  Property | Value
+  ---------|-------
+  id | 64131a70-beb9-4ccb-b590-4401e58446ec
+  displayName | Pradeep Gupta
+  givenName | Pradeep
+  jobTitle | Accountant
+  mail | PradeepG@contoso.com
+  officeLocation | 98/2202
+  preferredLanguage | en-US
+  surname | Gupta
+  userPrincipalName | PradeepG@contoso.com
+  type | user
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

package/docs/docs/cmd/aad/app/app-permission-add.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# aad app permission add
+
+Adds the specified application and/or delegated permissions to a specified Entra ID (Azure AD) app
+
+## Usage
+
+```sh
+m365 aad app permission add [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --appId [appId]`
+: Client ID of the Entra ID (Azure AD) app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra ID (Azure AD) app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
+
+`-a, --applicationPermissions [applicationPermissions]`
+: Space-separated list of application permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
+
+`-d, --delegatedPermissions [delegatedPermissions]`
+: Space-separated list of delegated permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
+
+`--grantAdminConsent`
+: When specified, grants application & delegated permissions through admin consent.
+```
+
+<Global />
+
+## Remarks
+
+Scopes/Roles to grant must be fully-qualified so that we can disambiguate them between the different resources.
+
+## Examples
+
+Grant multiple delegated API permissions to an Entra ID (Azure AD) app specified by client id
+
+```sh
+m365 aad app permission add --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
+```
+
+Grant multiple delegated API permissions to an Entra ID (Azure AD) app specified by object id
+
+```sh
+m365 aad app permission add --appObjectId 'e0306bb2-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
+```
+
+Grant multiple app-only permissions to an Entra ID (Azure AD) app specified by client id and grant admin consent
+
+```sh
+m365 aad app permission add --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --applicationPermissions 'https://graph.microsoft.com/Sites.FullControl.All https://microsoft.sharepoint-df.com/Sites.FullControl.All' --grandAdminConsent
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/teams/app/app-install.mdx

@@ -13,8 +13,11 @@ m365 teams app install [options]
 ## Options
 
 ```md definition-list
-`--id <id>`
-: The ID of the app to install
+`-i, --id [id]`
+: ID of the app to update. Specify either id or name, but not both
+
+`-n, --name [name]`
+: The display name of the app to update. Specify either id or name, but not both
 
 `--teamId [teamId]`
 : The ID of the Microsoft Teams team to which to install the app
@@ -52,6 +55,12 @@ Install a personal app for the user specified using their ID
 m365 teams app install --id 4440558e-8c73-4597-abc7-3644a64c4bce --userId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```
 
+Install an app with name _Test app_ from the catalog in a Microsoft Teams team
+
+```sh
+m365 teams app install --name "Test app" --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/teams/user/user-app-add.mdx

@@ -16,8 +16,11 @@ m365 teams user app add [options]
 `--id <id>`
 : The ID of the app to install.
 
-`--userId <userId>`
-: The ID of the user to install the app for.
+`--userId [userId]`
+: The ID of the user to install the app for. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: The UPN of the user to install the app for. Specify either `userId` or `userName` but not both.
 ```
 
 <Global />
@@ -28,12 +31,18 @@ The `id` has to be the ID of the app from the Microsoft Teams App Catalog. Do no
 
 ## Examples
 
-Install an app from the catalog for the specified user.
+Install an app from the catalog for the specified user by id.
 
 ```sh
 m365 teams user app add --id 4440558e-8c73-4597-abc7-3644a64c4bce --userId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```
 
+Install an app from the catalog for the specified user by name.
+
+```sh
+m365 teams user app add --id 4440558e-8c73-4597-abc7-3644a64c4bce --userName admin@contoso.com
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/teams/user/user-app-remove.mdx

@@ -20,10 +20,10 @@ m365 teams user app remove [options]
 : Name of the app instance installed for the user. Specify either `id` or `name`.
 
 `--userId [userId]`
-: The ID of the user to uninstall the app for. Specify `userId` or `userName` but not both.
+: The ID of the user to uninstall the app for. Specify either `userId` or `userName`.
 
 `--userName [userName]`
-: The UPN of the user to uninstall the app for. Specify `userId` or `userName` but not both.
+: The UPN of the user to uninstall the app for. Specify either `userId` or `userName`.
 
 `-f, --force`
 : Confirm removal of app for user.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "7.3.0-beta.4df0638",
+  "version": "7.3.0-beta.66401a3",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",