@pnp/cli-microsoft365 10.5.0-beta.395d550 → 10.5.0-beta.63404d1

package/docs/docs/cmd/graph/directoryextension/directoryextension-remove.mdx

@@ -0,0 +1,57 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# graph directoryextension remove
+
+Removes a directory extension
+
+## Usage
+
+```sh
+m365 graph directoryextension remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The ID of the directory extension to remove. Specify either `id` or `name`, but not both.
+
+`-n, --name [name]`
+: The name of the directory extension to remove. Specify either `id` or `name`, but not both.
+
+`--appId [appId]`
+: Application (client) ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appName [appName]`
+: The name of Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`-f, --force`
+: Don't prompt for confirmation before removing the directory extension
+```
+
+<Global />
+
+## Examples
+
+Remove a directory extension specified by name from an application specified by app object id and don't prompt for confirmation
+
+```sh
+m365 graph directoryextension remove --name extension_105be60b603845fea385e58772d9d630_githubworkaccount --appObjectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --force
+```
+
+Remove a directory extension specified by id from an application specified by app name and don't prompt for confirmation
+
+```sh
+m365 graph directoryextension remove --id 522817ae-5c95-4243-96c1-f85231fcbc1f --appName ContosoApp
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions

package/docs/docs/cmd/login.mdx

@@ -22,7 +22,7 @@ m365 login [options]
 : ID of the tenant from which accounts should authenticate. Use `common` or `organization` for multitenant apps. Defaults to `common` if not specified and if the config value `tenantId` and the environment variable `CLIMICROSOFT365_TENANT` are also not set.
 
 `-t, --authType [authType]`
-: The type of authentication to use. Allowed values `certificate`, `deviceCode`, `password`, `identity`, `browser`, `secret`. Default `deviceCode`
+: The type of authentication to use. Allowed values `certificate`, `deviceCode`, `password`, `identity`, `federatedIdentity`, `browser`, `secret`. Default `deviceCode`
 
 `-u, --userName [userName]`
 : Name of the user to authenticate. Required when `authType` is set to `password`
@@ -78,6 +78,8 @@ When logging in to Microsoft 365 using the user name and password, next to the a
 
 When logging in to Microsoft 365 using a certificate, the CLI for Microsoft 365 will store the contents of the certificate so that it can automatically re-authenticate if necessary. The contents of the certificate are removed by re-authenticating using the device code or by calling the [logout](logout.mdx) command.  
 
+Federated Identity is currently supported in GitHub Actions. To use this you need to set `authType` to `federatedIdentity` and specify `appId` and `tenant` to the values of the app registration you've configured a federated credential on. 
+
 To log in to Microsoft 365 using a certificate or secret, you will typically [create a custom Microsoft Entra application](../user-guide/using-own-identity.mdx). To use this application with the CLI for Microsoft 365, you will set the `CLIMICROSOFT365_ENTRAAPPID` environment variable to the application's ID and the `CLIMICROSOFT365_TENANT` environment variable to the ID of the Microsoft Entra tenant, where you created the Microsoft Entra application. Also, please make sure to read about [the caveats when using the certificate login option](../user-guide/cli-certificate-caveats.mdx).
 
 Managed identity in Azure Cloud Shell is the identity of the user. It is neither system- nor user-assigned and it can't be configured. To log in to Microsoft 365 using managed identity in Azure Cloud Shell, set `authType` to `identity` and don't specify the `userName` option.
@@ -182,6 +184,12 @@ Log in to Microsoft 365 using a user-assigned managed identity with `clientId` s
 m365 login --authType identity --userName ac9fbed5-804c-4362-a369-21a4ec51109e
 ```
 
+Log in to Microsoft 365 using a federated identity. Can currently only be used in GitHub Actions.
+
+```sh
+m365 login --authType federatedIdentity --appId eb96cfd0-abfa-4477-8d1d-c6dfde3efb19 --tenant 9a1a1bbd-e158-4cf5-967d-a53b8e85c628
+```
+
 Log in to Microsoft 365 using the interactive browser authentication with `clientId` set in the configuration. Uses the identity of the current user.
 
 ```sh

package/docs/docs/cmd/spo/homesite/homesite-add.mdx

@@ -0,0 +1,124 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo homesite add
+
+Adds a home site
+
+## Usage
+
+```sh
+m365 spo homesite add [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --url <url>`
+: URL of the site to use as a home site.
+
+`--isInDraftMode [isInDraftMode]`
+: Specifies whether the home site is in draft mode. Accepts `true` or `false`. Default is `false`. 
+
+`--vivaConnectionsDefaultStart [vivaConnectionsDefaultStart]`
+: Specifies whether the home site is the default start for Viva Connections. Accepts `true` or `false`. Default is `true`.
+
+`--audiences [audiences]`
+: Comma-separated list of Microsoft Entra group IDs that will be used as audience.
+
+`--order [order]`
+: Order of the home site. Must be a positive integer.
+```
+
+<Global />
+
+## Examples
+
+Add a home site
+
+```sh
+m365 spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms"
+```
+
+Add a home site with additional options
+
+```sh
+m365 spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms" --isInDraftMode true --vivaConnectionsDefaultStart false --audiences "af8c0bc8-7b1b-44b4-b087-ffcc8df70d16,754ff15c-76b1-44cb-88c7-0065a4d3cfb7" --order 2 
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "Audiences": [
+      {
+        "Email": "active@contoso.onmicrosoft.com",
+        "Id": "7a1eea7f-9ab0-40ff-8f2e-0083d9d63451",
+        "Title": "active Members"
+      }
+    ],
+    "IsInDraftMode": true,
+    "IsVivaBackendSite": false,
+    "SiteId": "ca49054c-85f3-41eb-a290-46ffda8f219c",
+    "TargetedLicenseType": 0,
+    "Title": "testcommsite",
+    "Url": "https://contoso.sharepoint.com/sites/testcomms",
+    "VivaConnectionsDefaultStart": false,
+    "WebId": "256c4f0f-e372-47b4-a891-b4888e829e20"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Audiences                  : [{"Email":"active@contoso.onmicrosoft.com","Id":"7a1eea7f-9ab0-40ff-8f2e-0083d9d63451","Title":"active Members"}]
+  IsInDraftMode              : true
+  IsVivaBackendSite          : false
+  SiteId                     : ca49054c-85f3-41eb-a290-46ffda8f219c
+  TargetedLicenseType        : 0
+  Title                      : testcommsite
+  Url                        : https://contoso.sharepoint.com/sites/testcomms
+  VivaConnectionsDefaultStart: false
+  WebId                      : 256c4f0f-e372-47b4-a891-b4888e829e20
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  IsInDraftMode,IsVivaBackendSite,SiteId,TargetedLicenseType,Title,Url,VivaConnectionsDefaultStart,WebId
+  1,0,ca49054c-85f3-41eb-a290-46ffda8f219c,0,testcommsite,https://contoso.sharepoint.com/sites/testcomms,0,256c4f0f-e372-47b4-a891-b4888e829e20
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms"
+
+  Date: 12/23/2024
+
+  ## testcommsite (https://contoso.sharepoint.com/sites/testcomms)
+
+  Property | Value
+  ---------|-------
+  IsInDraftMode | true
+  IsVivaBackendSite | false
+  SiteId | ca49054c-85f3-41eb-a290-46ffda8f219c
+  TargetedLicenseType | 0
+  Title | testcommsite
+  Url | https://contoso.sharepoint.com/sites/testcomms
+  VivaConnectionsDefaultStart | false
+  WebId | 256c4f0f-e372-47b4-a891-b4888e829e20
+  ```
+  </TabItem>
+</Tabs>
+
+## More information
+
+- SharePoint home sites [Viva Connections set up](https://learn.microsoft.com/en-us/viva/connections/set-up-admin-center)

package/docs/docs/cmd/spo/page/page-section-remove.mdx

@@ -0,0 +1,47 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo page section remove
+
+Removes the specified section from a modern page
+
+## Usage
+
+```sh
+m365 spo page section remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the page is located.
+
+`-n, --pageName <pageName>`
+: Name of the page from which to remove a section.
+
+`-s, --section <section>`
+: ID of the section to be removed.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+If the specified `pageName` doesn't refer to an existing modern page, you will get a _File doesn't exists_ error.
+
+## Examples
+
+Remove section of a modern page
+
+```sh
+m365 spo page section remove --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --section 1
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/viva/engage/engage-community-user-add.mdx

@@ -0,0 +1,67 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# viva engage community user add
+
+Adds a user to a specific Microsoft 365 Viva Engage community
+
+## Usage
+
+```sh
+m365 viva engage community user add [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --communityId [communityId]`
+: The ID of the Viva Engage community. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`-n, --communityDisplayName [communityDisplayName]`
+: The display name of the Viva Engage community. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`--entraGroupId [entraGroupId]`
+: The ID of the Microsoft 365 group. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`--ids [ids]`
+: Microsoft Entra IDs of users. You can pass a comma-separated list of multiple IDs. Specify either `ids` or `userNames` but not both.
+
+`--userNames [userNames]`
+: The user principal names of users. You can pass a comma-separated list of multiple UPNs. Specify either `ids` or `userNames` but not both.
+
+`-r, --role <role>`
+: The role to be assigned to the new users. Valid values: `Admin`, `Member`.
+```
+
+<Global />
+
+## Examples
+
+Add a single user specified by ID as a member to a community specified by display name.
+
+```sh
+m365 viva engage community user add --communityDisplayName "All company" --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
+```
+
+Add multiple users specified by ID as members to a community specified by ID.
+
+```sh
+m365 viva engage community user add --communityId eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIzNjAyMDAxMTAwOSJ9 --ids "098b9f52-f48c-4401-819f-29c33794c3f5,f1e06e31-3abf-4746-83c2-1513d71f38b8" --role Member
+```
+
+Add a single user specified by UPN as an admin to a community specified by display name.
+
+```sh
+m365 viva engage community user add --communityDisplayName "All company" --userNames john.doe@contoso.com --role Admin
+```
+
+Adds multiple users specified by UPN as admins to a community specified by its group ID.
+
+```sh
+m365 viva engage community user add --entraGroupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userNames "john.doe@contoso.com,adele.vance@contoso.com" --role Admin
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/viva/engage/engage-community-user-remove.mdx

@@ -0,0 +1,55 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# viva engage community user remove
+
+Removes a specified user from a Microsoft 365 Viva Engage community
+
+## Usage
+
+```sh
+m365 viva engage community user remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --communityId [communityId]`
+: The ID of the Viva Engage community. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`-n, --communityDisplayName [communityDisplayName]`
+: The display name of the Viva Engage community. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`--entraGroupId [entraGroupId]`
+: The ID of the Microsoft 365 group. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`--id [id]`
+: Microsoft Entra ID of the user. Specify either `id` or `userName` but not both.
+
+`--userName [userName]`
+: The user principal name of the user. Specify either `id` or `userName` but not both.
+
+`-f, --force`
+: Don't prompt for confirming removing the user from the specified Viva Engage community.
+```
+
+<Global />
+
+## Examples
+
+Remove a user specified by ID as a member from a community specified by display name.
+
+```sh
+m365 viva engage community user remove --communityDisplayName "All company" --id 098b9f52-f48c-4401-819f-29c33794c3f5
+```
+
+Remove a user specified by UPN from a community specified by its group ID without confirmation.
+
+```sh
+m365 viva engage community user remove --entraGroupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userName john.doe@contoso.com --force
+```
+
+## Response
+
+The command won't return a response on success.