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 Sep 18, 2024
2 parents 793b05b + 9a7d76f commit b2ae47f
Show file tree
Hide file tree
Showing 135 changed files with 11,156 additions and 2,535 deletions.
6 changes: 5 additions & 1 deletion .vscode/launch.json
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,11 @@
// 'm365 spo site get --url /', you'd use:
// "args": ["spo", "site", "get", "--url", "/"]
// after debugging, revert changes so that they won't end up in your PR
"args": []
"args": [],
"console": "integratedTerminal",
"env": {
"NODE_OPTIONS": "--enable-source-maps"
}
},
{
"type": "node",
Expand Down
6 changes: 6 additions & 0 deletions docs/docs/_clisettings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,11 @@ Setting name|Definition|Default value
------------|----------|-------------
`authType`|Default login method to use when running `m365 login` without the `--authType` option.|`deviceCode`
`autoOpenLinksInBrowser`|Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using `m365 login` in device code mode.|`false`
`clientId`|ID of the default Entra ID app use by the CLI to authenticate|``
`clientSecret`|Secret of the default Entra ID app use by the CLI to authenticate|``
`clientCertificateFile`|Path to the file containing the client certificate to use for authentication|``
`clientCertificateBase64Encoded`|Base64-encoded client certificate contents|``
`clientCertificatePassword`|Password to the client certificate file|``
`copyDeviceCodeToClipboard`|Automatically copy the device code to the clipboard when running `m365 login` command in device code mode|`false`
`csvEscape`|Single character used for escaping; only apply to characters matching the quote and the escape options|`"`
`csvHeader`|Display the column names on the first line|`true`
Expand All @@ -18,3 +23,4 @@ Setting name|Definition|Default value
`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|``
60 changes: 53 additions & 7 deletions docs/docs/about/release-notes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,53 @@ sidebar_position: 3

# Release notes

## v8.1.0 (beta)
## v9.1.0 (beta)

### New commands

**Power Automate:**

- [flow recyclebinitem list](../cmd/flow/recyclebinitem/recyclebinitem-list.mdx) - lists all soft-deleted Power Automate flows within an environment [#6139](https://github.com/pnp/cli-microsoft365/issues/6139)
- [flow recyclebinitem restore ](../cmd/flow/recyclebinitem/recyclebinitem-restore.mdx) - restores a soft-deleted Power Automate flow [#6140](https://github.com/pnp/cli-microsoft365/issues/6140)

**SharePoint:**

- [spo folder sharinglink add](../cmd/spo/folder/folder-sharinglink-add.mdx) - creates a new sharing link to a folder [#5963](https://github.com/pnp/cli-microsoft365/issues/5963)
- [spo folder sharinglink clear](../cmd/spo/folder/folder-sharinglink-clear.mdx) - removes all sharing links of a folder [#5965](https://github.com/pnp/cli-microsoft365/issues/5965)
- [spo folder sharinglink remove](../cmd/spo/folder/folder-sharinglink-remove.mdx) - removes a sharing links from a folder [#5966](https://github.com/pnp/cli-microsoft365/issues/5966)
- [spo site admin add](../cmd/spo/site/site-admin-add.mdx) - adds a user or group as a site collection administrator [#5883](https://github.com/pnp/cli-microsoft365/issues/5883)

**SharePoint Premium:**

- [spp contentcenter list](../cmd/spp/contentcenter/contentcenter-list.mdx) - gets the URLs of the SharePoint Premium content centers [#6101](https://github.com/pnp/cli-microsoft365/issues/6101)

### Changes

- enhanced 'flow export' endpoints. [#6297](https://github.com/pnp/cli-microsoft365/issues/6297)
- enhanced 'spo file' to use utils. [#5268](https://github.com/pnp/cli-microsoft365/issues/5268)
- enhanced [spo page section add](../cmd/spo/page/page-section-add.mdx) with extended zoneEmphasis options. [#5268](https://github.com/pnp/cli-microsoft365/issues/5268)
- fixed 'VersionPolicies' on generic list. [#6264](https://github.com/pnp/cli-microsoft365/issues/6264)
- fixed user retrieval using the correct property. [#6308](https://github.com/pnp/cli-microsoft365/issues/6308)
- enhanced [spo user get](../cmd/spo/user/user-get.mdx) with extra options. [#5516](https://github.com/pnp/cli-microsoft365/issues/5516)
- fixed logging in with passwordless certificate. [#6337](https://github.com/pnp/cli-microsoft365/issues/6337)
- fixed serializing bool values in CSV output. [#6326](https://github.com/pnp/cli-microsoft365/issues/6326)

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

### New commands

**Entra ID:**

- [entra enterpriseapp remove](../cmd/entra/enterpriseapp/enterpriseapp-remove.mdx) - deletes an enterprise application (or service principal) [#6111](https://github.com/pnp/cli-microsoft365/issues/6111)
- [entra group set](../cmd/entra/group/group-set.mdx) - updates a Microsoft Entra group [#5479](https://github.com/pnp/cli-microsoft365/issues/5479)
- [entra multitenant add](../cmd/entra/multitenant/multitenant-add.mdx) - creates a new multitenant organization [#6006](https://github.com/pnp/cli-microsoft365/issues/6006)
- [entra multitenant remove](../cmd/entra/multitenant/multitenant-remove.mdx) - removes a multitenant organization [#6009](https://github.com/pnp/cli-microsoft365/issues/6009)
- [entra multitenant set](../cmd/entra/multitenant/multitenant-set.mdx) - updates the properties of a multitenant organization [#6008](https://github.com/pnp/cli-microsoft365/issues/6008)

**Onenote:**

- [onenote notebook add ](../cmd/onenote/notebook/notebook-add.mdx) - creates a new OneNote notebook. [#3100](https://github.com/pnp/cli-microsoft365/issues/3100)

**SharePoint Embedded:**

- [spe containertype list](../cmd/spe/containertype/containertype-list.mdx) - retrieves a list of Container Types created for a SharePoint Embedded Application [#5989](https://github.com/pnp/cli-microsoft365/issues/5989)
Expand All @@ -23,17 +60,26 @@ sidebar_position: 3
- [spo folder sharinglink get](../cmd/spo/folder/folder-sharinglink-get.mdx) - gets details about a specific sharing link on a folder [#5962](https://github.com/pnp/cli-microsoft365/issues/5962)
- [spo folder sharinglink list](../cmd/spo/folder/folder-sharinglink-list.mdx) - lists sharing links on a folder [#5961](https://github.com/pnp/cli-microsoft365/issues/5961)

**Teams:**

- [teams message restore](../cmd/teams/message/message-restore.mdx) - restores a deleted message from a channel in a Microsoft Teams team [#5860](https://github.com/pnp/cli-microsoft365/issues/5860)

### Changes

- added 'componentProperties' option to 'spo spfx' commands [#5975](https://github.com/pnp/cli-microsoft365/issues/5975)
- added `componentProperties` option to `spo spfx` commands [#5975](https://github.com/pnp/cli-microsoft365/issues/5975)
- added prompting to [connection use](../cmd/connection/connection-use.mdx) [#6173](https://github.com/pnp/cli-microsoft365/issues/6173)
- enhanced [spo list roleassignment](../cmd/spo/list/list-roleassignment-add.mdx) commands with support for Entra groups [#6194](https://github.com/pnp/cli-microsoft365/issues/6194)
- fixed command [teams meeting list](../cmd/teams/meeting/meeting-list.mdx) [#5968](https://github.com/pnp/cli-microsoft365/issues/5968)
- introduced zod validation [#5639](https://github.com/pnp/cli-microsoft365/issues/5639)
- added 'VersionPolicies' to [spo list get](../cmd/spo/list/list-get.mdx) command [#5983](https://github.com/pnp/cli-microsoft365/issues/5983)
- added missing --force in example for [spo app uninstall](../cmd/spo/app/app-uninstall.mdx) command [#6245](https://github.com/pnp/cli-microsoft365/issues/6245)
- added `versionPolicies` to [spo list get](../cmd/spo/list/list-get.mdx) command [#5983](https://github.com/pnp/cli-microsoft365/issues/5983)
- added capabilities to add multiple users in an m365group [#6060](https://github.com/pnp/cli-microsoft365/issues/6060)
- added capabilities to set multiple users in an m365group [#6059](https://github.com/pnp/cli-microsoft365/issues/6059)
- enhanced the 'flow get' command to return additional properties [#4683](https://github.com/pnp/cli-microsoft365/issues/4683)
- enhanced [spo list roleassignment](../cmd/spo/list/list-roleassignment-add.mdx) commands with support for Entra groups [#6194](https://github.com/pnp/cli-microsoft365/issues/6194)
- enhanced the [flow get](../cmd/flow/flow-get.mdx) command to return additional properties [#4683](https://github.com/pnp/cli-microsoft365/issues/4683)
- introduced zod validation [#5639](https://github.com/pnp/cli-microsoft365/issues/5639)
- fixed [pa app export](../cmd/pa/app/app-export.mdx) without packageDisplayName [#6215](https://github.com/pnp/cli-microsoft365/issues/6215)
- fixed bug when parsing number arguments [#6211](https://github.com/pnp/cli-microsoft365/issues/6211)
- fixed command [teams meeting list](../cmd/teams/meeting/meeting-list.mdx) [#5968](https://github.com/pnp/cli-microsoft365/issues/5968)
- fixed prompting for missing required options in ZOD commands [#6219](https://github.com/pnp/cli-microsoft365/issues/6219)
- extended setup with a custom Entra app

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

Expand Down
65 changes: 65 additions & 0 deletions docs/docs/cmd/entra/enterpriseapp/enterpriseapp-remove.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
import Global from '/docs/cmd/_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# entra enterpriseapp remove

Deletes an enterprise application (or service principal)

## Usage

```sh
m365 entra enterpriseapp remove [options]
```

## Alias

```sh
m365 entra sp remove [options]
```

## Options

```md definition-list
`-i, --id [id]`
: ID of the enterprise application.

`-n, --displayName [displayName]`
: Display name of the enterprise application.

`--objectId [objectId]`
: ObjectId of the enterprise application.

`-f, --force`
: Don't prompt for confirmation.
```

<Global />

## Examples

Delete an enterprise application by application ID.

```sh
m365 entra enterpriseapp remove --id b2307a39-e878-458b-bc90-03bc578531d6 --force
```

Delete an enterprise application by display name.

```sh
m365 entra enterpriseapp remove --displayName "Contoso app"
```

Delete an enterprise application by object ID.

```sh
m365 entra enterpriseapp remove --objectId b2307a39-e878-458b-bc90-03bc578531dd
```

## Response

The command won't return a response on success.

## More information

- Application and service principal objects in Microsoft Entra ID: [https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects](https://learn.microsoft.com/azure/active-directory/develop/active-directory-application-objects)
4 changes: 0 additions & 4 deletions docs/docs/cmd/entra/group/group-add.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -53,8 +53,6 @@ m365 aad group add [options]

## Remarks

:::info

The `visibility` option affects the behavior of the group.

With the `Public` visibility:
Expand All @@ -74,8 +72,6 @@ With the `HiddenMembership` visibility:
- Administrators (global, company, user, and helpdesk) can view the membership of the group.
- The group appears in the global address book (GAL).

:::

:::note

The `HiddenMembership` visibility can be set only for Microsoft 365 groups when the groups are created. It can't be updated later.
Expand Down
89 changes: 89 additions & 0 deletions docs/docs/cmd/entra/group/group-set.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
import Global from '/docs/cmd/_global.mdx';

# entra group set

Updates a Microsoft Entra group

## Usage

```sh
m365 entra group set [options]
```

## Options

```md definition-list
`-i, --id [id]`
: The ID of the Microsoft Entra group to update. Specify either `id` or `displayName` but not both.

`-n, --displayName [displayName]`
: The display name of the Microsoft Entra group to update. Specify either `id` or `displayName` but not both.

`--newDisplayName [newDisplayName]`
: The new display name of the Microsoft Entra group. The maximum length is 256 characters.

`--description [description]`
: The new description for the group.

`--mailNickname [mailNickname]`
: The new mail alias for the group (part before the @). Use only for mail-enabled groups. Maximum length is 64 characters.

`--ownerIds [ownerIds]`
: Comma-separated list of IDs of Microsoft Entra users that will be the group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.

`--ownerUserNames [ownerUserNames]`
: Comma-separated list of UPNs of Microsoft Entra users that will be the group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.

`--memberIds [memberIds]`
: Comma-separated list of IDs of Microsoft Entra users that will be the group members. Specify either `memberIds` or `memberUserNames`, but not both.

`--memberUserNames [memberUserNames]`
: Comma-separated list of UPNs of Microsoft Entra users that will be the group members. Specify either `memberIds` or `memberUserNames`, but not both.

`--visibility [visibility]`
: Specifies the group join policy and group content visibility for Microsoft 365 groups. Possible values are: `Private` or `Public`. Specify only when targeting a Microsoft 365 group.
```

<Global />

## Remarks

The `visibility` option affects the behavior of the group.

With the `Public` visibility:
- Anyone can join the group without needing owner approval.
- Anyone can view the attributes of the group.
- Anyone can see the members of the group.

With the `Private` visibilty:
- Owner approval is needed to join the group.
- Anyone can view the attributes of the group.
- Anyone can see the members of the group.

If the specified option is not found, you will receive a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.

Specifying `memberIds` or `memberUserNames` will make only those users members, removing all others. Similarly, specifying `ownerIds` or `ownerUserNames` will make only those users owners, removing all others.

## Examples

Update the display name of a group specified by the display name

```sh
m365 entra group set --displayName Devs --newDisplayName Developers
```

Set the owners of a group to the specified people

```sh
m365 entra group set --id 57fd6b33-54eb-42b0-9ea0-8a9ac04eab7d --ownerUserNames "[email protected],[email protected]"
```

Update the description and mail nickname of a group

```sh
m365 entra group set --id 57fd6b33-54eb-42b0-9ea0-8a9ac04eab7d --description "All developers of the company" --mailNickname developers
```

## Response

The command won't return a response on success.
Loading

0 comments on commit b2ae47f

Please sign in to comment.