Skip to content

Commit

Permalink
Merge branch 'pnp:main' into main
Browse files Browse the repository at this point in the history
  • Loading branch information
tmaestrini authored Oct 12, 2024
2 parents 988904f + 7be7794 commit 329ef17
Show file tree
Hide file tree
Showing 205 changed files with 3,904 additions and 2,814 deletions.
1 change: 0 additions & 1 deletion docs/docs/_clisettings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,5 +22,4 @@ Setting name|Definition|Default value
`prompt`|Prompts for missing values in required options and enables interactive selection when multiple values are available for a command that requires a specific value to be retrieved.|`true`
`promptListPageSize`|By default, lists of choices longer than 7 will be paginated. Use this option to control how many choices will appear on the screen at once.|7
`showHelpOnFailure`|Automatically display help when executing a command failed|`true`
`showSpinner`|Display spinner when executing commands|`true`
`tenantId`|ID of the default tenant to use when authenticating with|``
48 changes: 43 additions & 5 deletions docs/docs/about/release-notes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,45 @@ sidebar_position: 3

# Release notes

## v9.1.0 (beta)
## v10.0.0 (beta)

### Changes

- extended `m365 login` with `--ensure` [#5217](https://github.com/pnp/cli-microsoft365/issues/5217)
- updated docs thumbnail [#6302](https://github.com/pnp/cli-microsoft365/issues/6302)

### ⚠️ Breaking changes

- updated option names of [app permission add](../cmd/app/permission/permission-add.mdx) to plural [#5719](https://github.com/pnp/cli-microsoft365/issues/5975)
- removed deprecated guest filtering for [entra m365group user list](../cmd/entra/m365group/m365group-user-list.mdx) command [#5558](https://github.com/pnp/cli-microsoft365/issues/5558)
- added `--force` option to [spo site appcatalog remove](../cmd/spo/site/site-appcatalog-remove.mdx) command [#6091](https://github.com/pnp/cli-microsoft365/issues/6091)
- aligned options with naming convention [#5616](https://github.com/pnp/cli-microsoft365/issues/5616)
- removed duplicate property from [spo list list](../cmd/spo/list/list-list.mdx) command [#6042](https://github.com/pnp/cli-microsoft365/issues/6042)
- updated [spo tenant recyclebinitem restore](../cmd/spo/tenant/tenant-recyclebinitem-restore.mdx) command output [#6063](https://github.com/pnp/cli-microsoft365/issues/6063)
- removed deprecated option `wait` option from [spo site remove](../cmd/spo/site/site-remove.mdx) command [#5956](https://github.com/pnp/cli-microsoft365/issues/5956)
- reworked command options of command [spo file copy](../cmd/spo/file/file-copy.mdx) [#6152](https://github.com/pnp/cli-microsoft365/issues/6152)
- removed deprecated CLI environment variables [#5918](https://github.com/pnp/cli-microsoft365/issues/5918)
- updated options of `entra enterpriseapp` commands [#6155](https://github.com/pnp/cli-microsoft365/issues/6155)
- removed `overwrite` option from [spfx project github workflow add](../cmd/spfx/project/project-github-workflow-add.mdx) command [#5765](https://github.com/pnp/cli-microsoft365/issues/5765)
- updated [status](../cmd/status.mdx) command output [#5849](https://github.com/pnp/cli-microsoft365/issues/5849)
- removed [spo folder rename](../cmd/spo/folder/folder-set.mdx) alias [#5911](https://github.com/pnp/cli-microsoft365/issues/5911)
- removed stringified property from [spo applicationcustomizer get](../cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx) command [#6052](https://github.com/pnp/cli-microsoft365/issues/6052)
- removed all `yammer` command aliases [#5764](https://github.com/pnp/cli-microsoft365/issues/5764)
- removed `showSpinner` config variable [#6126](https://github.com/pnp/cli-microsoft365/issues/6126)
- aligned options of `spo contenttype field` commands [#6170](https://github.com/pnp/cli-microsoft365/issues/6170)
- enhanced the output of [spo sitescript get](../cmd/spo/sitescript/sitescript-get.mdx) command [#5559](https://github.com/pnp/cli-microsoft365/issues/5559)
- updated [spo file move](../cmd/spo/file/file-move.mdx) options [#6153](https://github.com/pnp/cli-microsoft365/issues/6153)
- updated purpose of option `displayName` for [entra m365group set](../cmd/entra/m365group/m365group-set.mdx) command [#6146](https://github.com/pnp/cli-microsoft365/issues/6146)
- renamed command `spo site rename` to [spo tenant site rename](../cmd/spo/tenant/tenant-site-rename.mdx) [#6142](https://github.com/pnp/cli-microsoft365/issues/6142)
- removed `cli reconsent` command [#6360](https://github.com/pnp/cli-microsoft365/issues/6360)
- ensured empty result output for various list commands [#6288](https://github.com/pnp/cli-microsoft365/issues/6288)
- removed deprecated `userName` option from [entra m365group user add](../cmd/entra/m365group/m365group-user-add.mdx) command [#6218](https://github.com/pnp/cli-microsoft365/issues/6218)
- updated [cli doctor](../cmd/cli/cli-doctor.mdx) command output [#5923](https://github.com/pnp/cli-microsoft365/issues/5923)
- removed duplicate properties from [teams tab list](../cmd/teams/tab/tab-list.mdx) command [#5900](https://github.com/pnp/cli-microsoft365/issues/5900)
- renamed `entra group user <verb>` to `entra group member <verb>`. [#6396](https://github.com/pnp/cli-microsoft365/issues/6396)
- Updates setting users in `entra m365group set` [#6061](https://github.com/pnp/cli-microsoft365/issues/6061)

## [v9.1.0](https://github.com/pnp/cli-microsoft365/releases/tag/v9.1.0)

### New commands

Expand Down Expand Up @@ -176,7 +214,7 @@ sidebar_position: 3

**Entra ID:**

- [entra group user set](../cmd/entra/group/group-user-set.mdx) - updates role of users in an Entra group [#5473](https://github.com/pnp/cli-microsoft365/issues/5473)
- [entra group user set](../cmd/entra/group/group-member-set.mdx) - updates role of users in an Entra group [#5473](https://github.com/pnp/cli-microsoft365/issues/5473)
- [entra user groupmembership list](../cmd/entra/user/user-groupmembership-list.mdx) - retrieves all groups where the user is a member of [#5904](https://github.com/pnp/cli-microsoft365/issues/5904)

**Global:**
Expand Down Expand Up @@ -309,7 +347,7 @@ sidebar_position: 3

- [entra administrativeunit member remove](../cmd/entra/administrativeunit/administrativeunit-member-remove.mdx) - removes a member (user, group, or device) from an administrative unit [#5734](https://github.com/pnp/cli-microsoft365/issues/5734)
- [entra app permission list](../cmd/entra/app/app-permission-list.mdx) - lists the application and delegated permissions for a specified Entra Application Registration [#5668](https://github.com/pnp/cli-microsoft365/issues/5668)
- [entra group user add](../cmd/entra/group/group-user-add.mdx) - adds a user to a Microsoft Entra ID group [#5471](https://github.com/pnp/cli-microsoft365/issues/5471)
- [entra group user add](../cmd/entra/group/group-member-add.mdx) - adds a user to a Microsoft Entra ID group [#5471](https://github.com/pnp/cli-microsoft365/issues/5471)
- [entra group add](../cmd/entra/group/group-add.mdx) - creates a Microsoft Entra group [#5476](https://github.com/pnp/cli-microsoft365/issues/5476)
- [entra user registrationdetails list](../cmd/entra/user/user-registrationdetails-list.mdx) - retrieves a list of the authentication methods registered for users [#5773](https://github.com/pnp/cli-microsoft365/issues/5773)

Expand Down Expand Up @@ -467,7 +505,7 @@ sidebar_position: 3

**Entra ID**

- [entra group user list](../cmd/entra/group/group-user-list.mdx) - lists users of a specific Entra group [#5469](https://github.com/pnp/cli-microsoft365/issues/5469)
- [entra group user list](../cmd/entra/group/group-member-list.mdx) - lists users of a specific Entra group [#5469](https://github.com/pnp/cli-microsoft365/issues/5469)

### Changes

Expand Down Expand Up @@ -2997,7 +3035,7 @@ sidebar_position: 3
**SharePoint:**

- [spo feature disable](../cmd/spo/feature/feature-disable.mdx) - disables feature for the specified site or web [#676](https://github.com/pnp/cli-microsoft365/issues/676)
- [spo site rename](../cmd/spo/site/site-rename.mdx) - renames the URL and title of a site collection [#1197](https://github.com/pnp/cli-microsoft365/issues/1197)
- [spo site rename](../cmd/spo/tenant/tenant-site-rename.mdx) - renames the URL and title of a site collection [#1197](https://github.com/pnp/cli-microsoft365/issues/1197)

**Yammer:**

Expand Down
10 changes: 5 additions & 5 deletions docs/docs/cmd/app/permission/permission-add.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,10 +16,10 @@ m365 app permission add [options]
`--appId [appId]`
: Client ID of the Microsoft Entra app registered in the .m365rc.json file to retrieve API permissions for.

`--applicationPermission [applicationPermission]`
`--applicationPermissions [applicationPermissions]`
: Space-separated list of application permissions to add.

`--delegatedPermission [delegatedPermission]`
`--delegatedPermissions [delegatedPermissions]`
: Space-separated list of delegated permissions to add.

`--grantAdminConsent`
Expand All @@ -37,19 +37,19 @@ If you have multiple apps registered in your .m365rc.json file, you can specify
Adds the specified application permissions to the default app registered in the _.m365rc.json_ file while granting admin consent.

```sh
m365 app permission add --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --grantAdminConsent
m365 app permission add --applicationPermissions 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --grantAdminConsent
```

Adds the specified delegated permissions to the default app registered in the _.m365rc.json_ file without granting admin consent.

```sh
m365 app permission add --delegatedPermission 'https://graph.microsoft.com/offline_access'
m365 app permission add --delegatedPermissions 'https://graph.microsoft.com/offline_access'
```

Adds the specified application and delegated permissions to a specific app registered in the _.m365rc.json_ file while granting admin consent.

```sh
m365 app permission add --appId '1663767b-4172-4519-bfd1-28e6ff19055b' --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --delegatedPermission 'https://graph.microsoft.com/offline_access' --grantAdminConsent
m365 app permission add --appId '1663767b-4172-4519-bfd1-28e6ff19055b' --applicationPermissions 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --delegatedPermissions 'https://graph.microsoft.com/offline_access' --grantAdminConsent
```

## Response
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/cmd/cli/cli-consent.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ m365 cli consent [options]

```md definition-list
`-s, --service <service>`
: Service for which to consent permissions. Allowed values: `VivaEngage`, (deprecated)`yammer`.
: Service for which to consent permissions. Allowed values: `VivaEngage`.
```

<Global />
Expand Down
47 changes: 24 additions & 23 deletions docs/docs/cmd/cli/cli-doctor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ This command gets all the necessary diagnostic information needed to triage and

## Examples

Retrieve diagnostic information
Retrieve diagnostic information.

```sh
m365 cli doctor
Expand All @@ -42,43 +42,45 @@ m365 cli doctor
},
"cliVersion": "6.1.0",
"nodeVersion": "v16.13.0",
"cliAadAppId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
"cliAadAppTenant": "common",
"authMode": "DeviceCode",
"cliEntraAppId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
"cliEntraAppTenant": "common",
"authMode": "deviceCode",
"cliEnvironment": "",
"cliConfig": {
"output": "json",
"showHelpOnFailure": false
},
"roles": [],
"scopes": [
"AllSites.FullControl"
]
"scopes": {
"https://graph.microsoft.com": [
"AllSites.FullControl"
]
}
}
```

</TabItem>
<TabItem value="Text">

```text
authMode : DeviceCode
cliAadAppId : 31359c7f-bd7e-475c-86db-fdb8c937548e
cliAadAppTenant: common
cliConfig : {"output":"json","showHelpOnFailure":false}
cliEnvironment :
cliVersion : 6.1.0
nodeVersion : v16.13.0
os : {"platform":"win32","version":"Windows 10 Pro","release":"10.0.19045"}
roles : []
scopes : ["AllSites.FullControl"]
authMode : deviceCode
cliConfig : {"output":"json","showHelpOnFailure":false}
cliEntraAppId : 31359c7f-bd7e-475c-86db-fdb8c937548e
cliEntraAppTenant: common
cliEnvironment :
cliVersion : 6.1.0
nodeVersion : v16.13.0
os : {"platform":"win32","version":"Windows 10 Pro","release":"10.0.19045"}
roles : []
scopes : {"https://graph.microsoft.com":["AllSites.FullControl"]}
```

</TabItem>
<TabItem value="CSV">

```csv
os,cliVersion,nodeVersion,cliAadAppId,cliAadAppTenant,authMode,cliEnvironment,cliConfig,roles,scopes
"{""platform"":""win32"",""version"":""Windows 10 Pro"",""release"":""10.0.19045""}",6.1.0,v16.13.0,31359c7f-bd7e-475c-86db-fdb8c937548e,common,DeviceCode,,"{""output"":""json"",""showHelpOnFailure"":false}",[],"[""AllSites.FullControl""]"
os,cliVersion,nodeVersion,cliEntraAppId,cliEntraAppTenant,authMode,cliEnvironment,cliConfig,roles,scopes
"{""platform"":""win32"",""version"":""Windows 10 Pro"",""release"":""10.0.19045""}",6.1.0,v16.13.0,31359c7f-bd7e-475c-86db-fdb8c937548e,common,deviceCode,,"{""output"":""json"",""showHelpOnFailure"":false}",[],"{""https://graph.microsoft.com"":[""AllSites.FullControl""]}"
```

</TabItem>
Expand All @@ -93,12 +95,11 @@ m365 cli doctor
---------|-------
cliVersion | 6.1.0
nodeVersion | v16.13.0
cliAadAppId | 31359c7f-bd7e-475c-86db-fdb8c937548e
cliAadAppTenant | common
authMode | DeviceCode
cliEntraAppId | 31359c7f-bd7e-475c-86db-fdb8c937548e
cliEntraAppTenant | common
authMode | deviceCode
cliEnvironment |
```

</TabItem>
</Tabs>

62 changes: 0 additions & 62 deletions docs/docs/cmd/cli/cli-reconsent.mdx

This file was deleted.

24 changes: 12 additions & 12 deletions docs/docs/cmd/entra/enterpriseapp/enterpriseapp-add.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,39 +22,39 @@ m365 entra sp add [options]
## Options

```md definition-list
`--appId [appId]`
: ID of the app for which the enterprise application should be created
`-i, --id [id]`
: ID of the app for which the enterprise application should be created.

`--appName [appName]`
: Display name of the app for which the enterprise application should be created
`-n, --displayName [displayName]`
: Display name of the app for which the enterprise application should be created.

`--objectId [objectId]`
: ObjectId of the app for which the enterprise application should be created
: ObjectId of the app for which the enterprise application should be created.
```

<Global />

## Remarks

Specify either the `appId`, `appName` or `objectId`. If you specify more than one option value, the command will fail with an error.
Specify either the `id`, `displayName` or `objectId`. If you specify more than one option value, the command will fail with an error.

If you register an application in the portal, an application object as well as an enterprise application object are automatically created in your home tenant. If you register an application using CLI for Microsoft 365 or the Microsoft Graph, you'll need to create the enterprise application separately. To register/create an application using the CLI for Microsoft 365, use the [m365 entra app add](../app/app-add.mdx) command.

## Examples

Creates an enterprise application for a registered Entra app with appId _b2307a39-e878-458b-bc90-03bc578531d6_.
Creates an enterprise application for a registered Entra app with the specified id.

```sh
m365 entra enterpriseapp add --appId b2307a39-e878-458b-bc90-03bc578531d6
m365 entra enterpriseapp add --id b2307a39-e878-458b-bc90-03bc578531d6
```

Creates an enterprise application for a registered Entra app with appName _Microsoft Graph_.
Creates an enterprise application for a registered Entra app with the specified displayName.

```sh
m365 entra enterpriseapp add --appName "Microsoft Graph"
m365 entra enterpriseapp add --displayName "Microsoft Graph"
```

Creates an enterprise application for a registered Entra app with objectId _b2307a39-e878-458b-bc90-03bc578531d6_.
Creates an enterprise application for a registered Entra app with the specified objectId.

```sh
m365 entra enterpriseapp add --objectId b2307a39-e878-458b-bc90-03bc578531d6
Expand Down Expand Up @@ -172,7 +172,7 @@ m365 entra enterpriseapp add --objectId b2307a39-e878-458b-bc90-03bc578531d6
<TabItem value="Markdown">

```md
# entra enterpriseapp add --appId "8da75b6a-4272-4b17-8ee1-20ba66e2b06f"
# entra enterpriseapp add --id "8da75b6a-4272-4b17-8ee1-20ba66e2b06f"

Date: 2023-06-02

Expand Down
Loading

0 comments on commit 329ef17

Please sign in to comment.