Adds a new command: 'spo site admin remove'. Closes pnp#5884

docs/docs/cmd/spo/site/site-admin-remove.mdx

@@ -0,0 +1,67 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo site admin remove
+
+Removes a user or group as site collection administrator
+
+## Usage
+
+```sh
+m365 spo site admin remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --siteUrl <siteUrl>`
+: The URL of the SharePoint site
+
+`--userId [userId]`
+: The ID of the user to remove as a site collection admin
+
+`--userName [userName]`
+: The user principal name of the user to remove as a site collection admin
+
+`--groupId [groupId]`
+: The ID of the Microsoft Entra ID group to remove as a site collection admin
+
+`--groupName [groupName]`
+: The name of the Microsoft Entra ID group to remove as a site collection admin
+
+`--asAdmin`
+: If specified, we will use the SharePoint admin center to execute the command
+
+`-f, --force`
+: Don't prompt for confirmation
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command with the `--asAdmin` mode, you have to have permissions to access the tenant admin site.
+
+Without this parameter, you have to have site collection admin permissions for the requested site.
+
+:::
+
+## Examples
+
+Removes user as site collection admin
+
+```sh
+m365 spo site admin remove --siteUrl https://contoso.sharepoint.com --userId 600713c5-53c6-4f24-b454-3c35e22b2639
+```
+
+Removes group as site collection admin without prompting for confirmation as SharePoint Admin
+
+```sh
+m365 spo site admin remove --siteUrl https://contoso.sharepoint.com --groupName SP_Administrators --force --asAdmin
+```
+## Response
+
+The command won't return a response on success.

docs/src/config/sidebars.ts

@@ -3271,6 +3271,11 @@ const sidebars: SidebarsConfig = {
               label: 'site add',
               id: 'cmd/spo/site/site-add'
             },
+            {
+              type: 'doc',
+              label: 'site admin remove',
+              id: 'cmd/spo/site/site-admin-remove'
+            },
             {
               type: 'doc',
               label: 'site ensure',

src/m365/spo/commands.ts

@@ -240,6 +240,7 @@ export default {
   SERVICEPRINCIPAL_SET: `${prefix} serviceprincipal set`,
   SET: `${prefix} set`,
   SITE_ADD: `${prefix} site add`,
+  SITE_ADMIN_REMOVE: `${prefix} site admin remove`,
   SITE_APPCATALOG_ADD: `${prefix} site appcatalog add`,
   SITE_APPCATALOG_LIST: `${prefix} site appcatalog list`,
   SITE_APPCATALOG_REMOVE: `${prefix} site appcatalog remove`,

src/m365/spo/commands/site/SiteProperties.ts

@@ -2,4 +2,5 @@ export interface SiteProperties {
   Status: string;
   Title: string;
   Url: string;
+  SiteId: string;
 }