@pnp/cli-microsoft365 10.8.0-beta.cdb5c81 → 10.9.0-beta.9d7d19b

package/dist/m365/spp/commands/model/model-get.js

@@ -4,8 +4,6 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _SppModelGetCommand_instances, _SppModelGetCommand_initTelemetry, _SppModelGetCommand_initOptions, _SppModelGetCommand_initValidators, _SppModelGetCommand_initOptionSets, _SppModelGetCommand_initTypes;
-import request from '../../../../request.js';
-import { formatting } from '../../../../utils/formatting.js';
 import { odata } from '../../../../utils/odata.js';
 import { spp } from '../../../../utils/spp.js';
 import { urlUtil } from '../../../../utils/urlUtil.js';
@@ -30,34 +28,19 @@ class SppModelGetCommand extends SpoCommand {
     }
     async commandAction(logger, args) {
         try {
-            if (this.verbose) {
-                await logger.log(`Retrieving model information from ${args.options.siteUrl}...`);
-            }
             const siteUrl = urlUtil.removeTrailingSlashes(args.options.siteUrl);
-            await spp.assertSiteIsContentCenter(siteUrl);
-            let requestUrl = `${siteUrl}/_api/machinelearning/models/`;
+            await spp.assertSiteIsContentCenter(siteUrl, logger, this.verbose);
+            let result = null;
             if (args.options.title) {
-                let requestTitle = args.options.title.toLowerCase();
-                if (!requestTitle.endsWith('.classifier')) {
-                    requestTitle += '.classifier';
-                }
-                requestUrl += `getbytitle('${formatting.encodeQueryParameter(requestTitle)}')`;
+                result = await spp.getModelByTitle(siteUrl, args.options.title, logger, this.verbose);
             }
             else {
-                requestUrl += `getbyuniqueid('${args.options.id}')`;
-            }
-            const requestOptions = {
-                url: requestUrl,
-                headers: {
-                    accept: 'application/json;odata=nometadata'
-                },
-                responseType: 'json'
-            };
-            const result = await request.get(requestOptions);
-            if (result['odata.null'] === true) {
-                throw 'Model not found.';
+                result = await spp.getModelById(siteUrl, args.options.id, logger, this.verbose);
             }
             if (args.options.withPublications) {
+                if (this.verbose) {
+                    await logger.log(`Retrieving publications for model...`);
+                }
                 result.Publications = await odata.getAllItems(`${siteUrl}/_api/machinelearning/publications/getbymodeluniqueid('${result.UniqueId}')`);
             }
             await logger.log({

package/dist/m365/spp/commands/model/model-list.js

@@ -33,7 +33,7 @@ class SppModelListCommand extends SpoCommand {
                 await logger.log(`Retrieving models from ${args.options.siteUrl}...`);
             }
             const siteUrl = urlUtil.removeTrailingSlashes(args.options.siteUrl);
-            await spp.assertSiteIsContentCenter(siteUrl);
+            await spp.assertSiteIsContentCenter(siteUrl, logger, this.verbose);
             const result = await odata.getAllItems(`${siteUrl}/_api/machinelearning/models`);
             await logger.log(result);
         }

package/dist/m365/spp/commands/model/model-remove.js

@@ -40,7 +40,7 @@ class SppModelRemoveCommand extends SpoCommand {
                 await logger.log(`Removing model from ${args.options.siteUrl}...`);
             }
             const siteUrl = urlUtil.removeTrailingSlashes(args.options.siteUrl);
-            await spp.assertSiteIsContentCenter(siteUrl);
+            await spp.assertSiteIsContentCenter(siteUrl, logger, this.verbose);
             let requestUrl = `${siteUrl}/_api/machinelearning/models/`;
             if (args.options.title) {
                 let requestTitle = args.options.title.toLowerCase();

package/dist/m365/spp/commands.js

@@ -1,6 +1,7 @@
 const prefix = 'spp';
 export default {
     CONTENTCENTER_LIST: `${prefix} contentcenter list`,
+    MODEL_APPLY: `${prefix} model apply`,
     MODEL_GET: `${prefix} model get`,
     MODEL_LIST: `${prefix} model list`,
     MODEL_REMOVE: `${prefix} model remove`

package/dist/utils/spp.js

@@ -1,11 +1,17 @@
 import request from '../request.js';
+import { formatting } from './formatting.js';
 export const spp = {
     /**
      * Asserts whether the specified site is a content center
      * @param siteUrl The URL of the site to check
+     * @param logger Logger instance
+     * @param verbose Whether to log verbose messages
      * @throws error when site is not a content center.
      */
-    async assertSiteIsContentCenter(siteUrl) {
+    async assertSiteIsContentCenter(siteUrl, logger, verbose) {
+        if (verbose) {
+            await logger.log(`Checking if '${siteUrl}' is a valid content center site...`);
+        }
         const requestOptions = {
             url: `${siteUrl}/_api/web?$select=WebTemplateConfiguration`,
             headers: {
@@ -17,6 +23,58 @@ export const spp = {
         if (response.WebTemplateConfiguration !== 'CONTENTCTR#0') {
             throw Error(`${siteUrl} is not a content site.`);
         }
+    },
+    /**
+     * Gets a SharePoint Premium model by title
+     * @param contentCenterUrl a content center site URL
+     * @param title model title
+     * @param logger Logger instance
+     * @param verbose Whether to log verbose messages
+     * @returns SharePoint Premium model
+     */
+    async getModelByTitle(contentCenterUrl, title, logger, verbose) {
+        if (verbose) {
+            await logger.log(`Retrieving model information...`);
+        }
+        let requestTitle = title.toLowerCase();
+        if (!requestTitle.endsWith('.classifier')) {
+            requestTitle += '.classifier';
+        }
+        const requestUrl = `${contentCenterUrl}/_api/machinelearning/models/getbytitle('${formatting.encodeQueryParameter(requestTitle)}')`;
+        const requestOptions = {
+            url: requestUrl,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const result = await request.get(requestOptions);
+        if (result['odata.null'] === true) {
+            throw Error(`Model '${title}' was not found.`);
+        }
+        return result;
+    },
+    /**
+     * Gets a SharePoint Premium model by unique id
+     * @param contentCenterUrl a content center site URL
+     * @param id model unique id
+     * @param logger Logger instance
+     * @param verbose Whether to log verbose messages
+     * @returns SharePoint Premium model
+     */
+    async getModelById(contentCenterUrl, id, logger, verbose) {
+        if (verbose) {
+            await logger.log(`Retrieving model information...`);
+        }
+        const requestUrl = `${contentCenterUrl}/_api/machinelearning/models/getbyuniqueid('${id}')`;
+        const requestOptions = {
+            url: requestUrl,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        return await request.get(requestOptions);
     }
 };
 //# sourceMappingURL=spp.js.map

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

@@ -0,0 +1,135 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph directoryextension list
+
+Retrieves a list of directory extensions
+
+## Usage
+
+```sh
+m365 graph directoryextension list [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Application (client) ID of the Entra application where the directory extensions are registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra application where the directory extensions are registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appName [appName]`
+: The name of Entra application where the directory extensions are registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+```
+
+<Global />
+
+## Remarks
+
+When neither `appId`, `appObjectId` nor `appName` is specified, the command will return all available directory extensions including those registered for multi-tenant apps.
+
+https://learn.microsoft.com/en-us/graph/api/directoryobject-getavailableextensionproperties?view=graph-rest-1.0&tabs=http
+
+Otherwise, it will return directory extensions for a specific application.
+
+https://learn.microsoft.com/en-us/graph/api/application-list-extensionproperty?view=graph-rest-1.0&tabs=http
+
+## Examples
+
+Get all available directory extensions including those registered for multi-tenant apps
+
+```sh
+m365 graph directoryextension list
+```
+
+Get all directory extensions registered for an application specified by app id.
+
+```sh
+m365 graph directoryextension list --appId fd918e4b-c821-4efb-b50a-5eddd23afc6f
+```
+
+Get all directory extensions registered for an application specified by app object id.
+
+```sh
+m365 graph directoryextension list --appObjectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844
+```
+
+Get all directory extensions registered for an application specified by name.
+
+```sh
+m365 graph directoryextension list --appName ContosoApp
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "8133c498-ad76-4a7b-90a0-675bf5adf492",
+      "deletedDateTime": null,
+      "appDisplayName": "ContosoApp",
+      "dataType": "String",
+      "isMultiValued": true,
+      "isSyncedFromOnPremises": false,
+      "name": "extension_66eac1c505384aec9e024b9e60f5e4b9_jobGroup",
+      "targetObjects": [
+        "User"
+      ]
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appDisplayName        : ContosoApp
+  dataType              : String
+  deletedDateTime       : null
+  id                    : 8133c498-ad76-4a7b-90a0-675bf5adf492
+  isMultiValued         : true
+  isSyncedFromOnPremises: false
+  name                  : extension_66eac1c505384aec9e024b9e60f5e4b9_jobGroup
+  targetObjects         : ["User"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,appDisplayName,dataType,isMultiValued,isSyncedFromOnPremises,name
+  8133c498-ad76-4a7b-90a0-675bf5adf492,,ContosoApp,String,1,0,extension_66eac1c505384aec9e024b9e60f5e4b9_jobGroup
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph directoryextension list --debug "false" --verbose "false" --appId "66eac1c5-0538-4aec-9e02-4b9e60f5e4b9"
+
+  Date: 3/23/2025
+
+  ## extension_66eac1c505384aec9e024b9e60f5e4b9_jobGroup (8133c498-ad76-4a7b-90a0-675bf5adf492)
+
+  Property | Value
+  ---------|-------
+  id | 8133c498-ad76-4a7b-90a0-675bf5adf492
+  appDisplayName | ContosoApp
+  dataType | String
+  isMultiValued | true
+  isSyncedFromOnPremises | false
+  name | extension\_66eac1c505384aec9e024b9e60f5e4b9\_jobGroup
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions

package/docs/docs/cmd/spo/list/list-get.mdx

@@ -19,13 +19,16 @@ m365 spo list get [options]
 : URL of the site where the list to retrieve is located.
 
 `-i, --id [id]`
-: ID of the list to retrieve information for. Specify either `id`, `title`, or `url` but not multiple.
+: ID of the list to retrieve information for. Specify either `id`, `title`,`url` or `default` but not multiple.
 
 `-t, --title [title]`
-: Title of the list to retrieve information for. Specify either `id`, `title`, or `url` but not multiple.
+: Title of the list to retrieve information for. Specify either `id`, `title`,`url` or `default` but not multiple.
 
 `--url [url]`
-: Server- or site-relative URL of the list. Specify either `id`, `title`, or `url` but not multiple.
+: Server- or site-relative URL of the list. Specify either `id`, `title`,`url` or `default` but not multiple.
+
+`--default`
+: Set to retrieve the default list from the site. Specify either `id`, `title`, `url`, or `default` but not multiple.  
 
 `-p, --properties [properties]`
 : Comma-separated list of properties to retrieve from the list. Will retrieve all properties possible from default response, if not specified.
@@ -42,6 +45,12 @@ When the `properties` option includes values with a `/`, for example: `ListItemA
 
 ## Examples
 
+Get the default document library located in the specified site.
+
+```sh
+m365 spo list get --webUrl https://contoso.sharepoint.com/sites/project-x --default  
+```
+
 Get information about a list with specified ID located in the specified site.
 
 ```sh

package/docs/docs/cmd/spp/model/model-apply.mdx

@@ -0,0 +1,79 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spp model apply
+
+Applies (or syncs) a trained document understanding model to a document library
+
+## Usage
+
+```sh
+m365 spp model apply [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the web where the library is located.
+
+`-c, --contentCenterUrl <contentCenterUrl>`
+: The URL of the content center site where model is located.
+
+`-i, --id [id]`
+: The unique ID of the model. Specify either `id` or `title` but not both.
+
+`-t, --title [title]`
+: The display name of the model. Specify either `id` or `title` but not both.
+
+`--listTitle [listTitle]`
+: The title of the document library to which the model will be applied. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
+
+`--listId [listId]`
+: The ID of the library to which the model will be applied. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
+
+`--listUrl [listUrl]`
+: Server or web-relative URL of the library to which the model will be applied. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
+
+`--viewOption [viewOption]`
+: Defines whether the model view should be set as the default view for the document library. Allowed values are: `NewViewAsDefault`, `DoNotChangeDefault`, `TileViewAsDefault`. The default value is `NewViewAsDefault`.
+```
+
+<Global />
+
+## Examples
+
+Applies a trained document understanding model using its unique ID to a document library, identified by its title.
+
+```sh
+m365 spp model apply --webUrl "https://contoso.sharepoint.com" --contentCenterUrl "https://contoso.sharepoint.com/sites/ContentCenter" --id "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc" --listTitle "Shared Documents"
+```
+
+Applies a trained document understanding model using its display name to a document library, identified by its title.
+
+```sh
+m365 spp model apply --webUrl "https://contoso.sharepoint.com" --contentCenterUrl "https://contoso.sharepoint.com/sites/ContentCenter" --title "ModelExample" --listTitle "Shared Documents"
+```
+
+Applies a trained document understanding model using its display name to a document library, identified by its URL.
+
+```sh
+m365 spp model apply --webUrl "https://contoso.sharepoint.com" --contentCenterUrl "https://contoso.sharepoint.com/sites/ContentCenter" --title "ModelExample" --listUrl "/Shared Documents"
+```
+
+Applies a trained document understanding model using its display name to a document library, identified by its unique ID.
+
+```sh
+m365 spp model apply --webUrl "https://contoso.sharepoint.com" --contentCenterUrl "https://contoso.sharepoint.com/sites/ContentCenter" --title "ModelExample" --listId "b4cfa0d9-b3d7-49ae-a0f0-f14ffdd005f7"
+```
+
+Applies a trained document understanding model using its display name to a document library, identified by its unique ID. Without changing a default document library view.
+
+```sh
+m365 spp model apply --webUrl "https://contoso.sharepoint.com" --contentCenterUrl "https://contoso.sharepoint.com/sites/ContentCenter" --title "ModelExample" --listId "b4cfa0d9-b3d7-49ae-a0f0-f14ffdd005f7" --viewOption "DoNotChangeDefault"
+```
+
+## Response
+
+The command won't return a response on success.

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "10.8.0",
+  "version": "10.9.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@pnp/cli-microsoft365",
-      "version": "10.8.0",
+      "version": "10.9.0",
       "license": "MIT",
       "dependencies": {
         "@azure/msal-common": "^15.5.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "10.8.0-beta.cdb5c81",
+  "version": "10.9.0-beta.9d7d19b",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -177,7 +177,7 @@
     "Levert, Sebastien <slevert@outlook.com>",
     "Lingstuyl, Martin <mlingstuyl@live.com>",
     "Macháček, Martin <machacek@edhouse.cz>",
-    "Maestrini Tobias <tobias@bee365.ch>",
+    "Maestrini, Tobias <tobias.maestrini@gmail.com>",
     "Maillot, Michaël <battosaimykle@gmail.com>",
     "Mastykarz, Waldek <waldek@mastykarz.nl>",
     "McDonnell, Kevin <kevin@mcd79.com>",