@pnp/cli-microsoft365 10.8.0-beta.a51d886 → 10.8.0

package/dist/utils/spo.js

@@ -53,24 +53,6 @@ export const spo = {
         };
         return context;
     },
-    async getAllContainerTypes(spoAdminUrl, logger, verbose) {
-        const formDigestInfo = await spo.ensureFormDigest(spoAdminUrl, logger, undefined, verbose);
-        const requestOptions = {
-            url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
-            headers: {
-                'X-RequestDigest': formDigestInfo.FormDigestValue
-            },
-            data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="46" ObjectPathId="45" /><Method Name="GetSPOContainerTypes" Id="47" ObjectPathId="45"><Parameters><Parameter Type="Enum">1</Parameter></Parameters></Method></Actions><ObjectPaths><Constructor Id="45" TypeId="{268004ae-ef6b-4e9b-8425-127220d84719}" /></ObjectPaths></Request>`
-        };
-        const res = await request.post(requestOptions);
-        const json = JSON.parse(res);
-        const response = json[0];
-        if (response.ErrorInfo) {
-            throw new Error(response.ErrorInfo.ErrorMessage);
-        }
-        const containerTypes = json[json.length - 1];
-        return containerTypes;
-    },
     async waitUntilFinished({ operationId, siteUrl, logger, currentContext, debug, verbose }) {
         const resFormDigest = await spo.ensureFormDigest(siteUrl, logger, currentContext, debug);
         currentContext = resFormDigest;

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/dist/utils/zod.js

@@ -110,16 +110,41 @@ function parseDef(def, options, currentOption) {
         }
     } while (parsedDef);
 }
+function optionToString(optionInfo) {
+    let s = '';
+    if (optionInfo.short) {
+        s += `-${optionInfo.short}, `;
+    }
+    s += `--${optionInfo.long}`;
+    if (optionInfo.type !== 'boolean') {
+        s += ' ';
+        s += optionInfo.required ? '<' : '[';
+        s += optionInfo.long;
+        s += optionInfo.required ? '>' : ']';
+    }
+    return s;
+}
+;
 export const zod = {
     alias(alias, type) {
         type._def.alias = alias;
         return type;
     },
-    schemaToOptions(schema) {
+    schemaToOptionInfo(schema) {
         const options = [];
         parseDef(schema._def, options);
         return options;
     },
+    schemaToOptions(schema) {
+        const optionsInfo = this.schemaToOptionInfo(schema);
+        const options = optionsInfo.map(option => {
+            return {
+                option: optionToString(option),
+                autocomplete: option.autocomplete
+            };
+        });
+        return options;
+    },
     coercedEnum: (e) => z.preprocess(val => {
         const target = String(val)?.toLowerCase();
         for (const k of Object.values(e)) {

package/docs/docs/cmd/adaptivecard/adaptivecard-send.mdx

@@ -17,7 +17,7 @@ m365 adaptivecard send [options]
 : URL where to send the card to.
 
 `-t, --title [title]`
-: Title of the card. Specify either `title` or `card` but not both.
+: Title of the card. If you specify `title` and `card`, the `title` will be merged into the card.
 
 `-d, --description [description]`
 : Contents of the card.

package/docs/docs/cmd/cli/app/app-reconsent.mdx

@@ -0,0 +1,63 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# cli app reconsent
+
+Reconsent all permission scopes used in CLI for Microsoft 365
+
+## Usage
+
+```sh
+m365 cli app reconsent [options]
+```
+
+## Options
+
+<Global />
+
+## Remarks
+
+This command will add all missing scopes used in CLI for Microsoft 365 to your current app registration. It will only add missing scopes and won't remove any scopes that are already present in the app registration.
+
+## Examples
+
+Consent all permission scopes used in CLI for Microsoft 365 to the current app registration
+
+```sh
+m365 cli app reconsent
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  "To consent to the new scopes for your Microsoft Entra application registration, please navigate to the following URL: https://login.microsoftonline.com/f72203fd-b0a0-472d-85eb-079a117a80de/adminconsent?client_id=62b981af-59d3-4d25-8baf-6cc067a03102"
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  To consent to the new scopes for your Microsoft Entra application registration, please navigate to the following URL: https://login.microsoftonline.com/f72203fd-b0a0-472d-85eb-079a117a80de/adminconsent?client_id=62b981af-59d3-4d25-8baf-6cc067a03102
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  To consent to the new scopes for your Microsoft Entra application registration, please navigate to the following URL: https://login.microsoftonline.com/f72203fd-b0a0-472d-85eb-079a117a80de/adminconsent?client_id=62b981af-59d3-4d25-8baf-6cc067a03102
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  To consent to the new scopes for your Microsoft Entra application registration, please navigate to the following URL: https://login.microsoftonline.com/f72203fd-b0a0-472d-85eb-079a117a80de/adminconsent?client_id=62b981af-59d3-4d25-8baf-6cc067a03102
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/entra/organization/organization-list.mdx

@@ -0,0 +1,154 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra organization list
+
+Retrieves a list of organizations
+
+## Usage
+
+```sh
+m365 entra organization list [options]
+```
+
+## Options
+
+```md definition-list
+`-p, --properties [properties]`
+: The comma separated list of properties to be returned.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+Applications granted the `User.Read` permission are able to read only the id, displayName, and verifiedDomains properties of the organization. 
+All other properties return with null values. To read all properties, use at least `Organization.Read.All`.
+
+:::
+
+## Examples
+
+Retrieve organizations
+
+```sh
+m365 entra organization list
+```
+
+Retrieve specific info
+
+```sh
+m365 entra organization list --properties 'id,displayName,tenantType'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "e65b162c-6f87-4eb1-a24e-1b37d3504663",
+      "deletedDateTime": null,
+      "businessPhones": [
+        "4258828080"
+      ],
+      "city": null,
+      "country": null,
+      "countryLetterCode": "IE",
+      "createdDateTime": "2023-02-21T19:56:38Z",
+      "defaultUsageLocation": null,
+      "displayName": "Contoso",
+      "isMultipleDataLocationsForServicesEnabled": null,
+      "marketingNotificationEmails": [],
+      "onPremisesLastSyncDateTime": null,
+      "onPremisesSyncEnabled": null,
+      "partnerTenantType": null,
+      "postalCode": null,
+      "preferredLanguage": "en",
+      "securityComplianceNotificationMails": [],
+      "securityComplianceNotificationPhones": [],
+      "state": null,
+      "street": null,
+      "technicalNotificationMails": [
+        "john.doe@contoso.com"
+      ],
+      "tenantType": "AAD",
+      "directorySizeQuota": {
+        "used": 1400,
+        "total": 300000
+      },
+      "assignedPlans": [],
+      "onPremisesSyncStatus": [],
+      "privacyProfile": {
+        "contactEmail": "john.doe@contoso.com",
+        "statementUrl": ""
+      },
+      "provisionedPlans": [],
+      "verifiedDomains": [
+        {
+          "capabilities": "Email, OfficeCommunicationsOnline",
+          "isDefault": true,
+          "isInitial": true,
+          "name": "contoso.onmicrosoft.com",
+          "type": "Managed"
+        },
+        {
+          "capabilities": "Email, OfficeCommunicationsOnline, MoeraDomain",
+          "isDefault": false,
+          "isInitial": false,
+          "name": "contoso2.onmicrosoft.com",
+          "type": "Managed"
+        }
+      ]
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  displayName: Contoso
+  id         : e65b162c-6f87-4eb1-a24e-1b37d3504663
+  tenantType : AAD
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,city,country,countryLetterCode,createdDateTime,defaultUsageLocation,displayName,isMultipleDataLocationsForServicesEnabled,onPremisesLastSyncDateTime,onPremisesSyncEnabled,partnerTenantType,postalCode,preferredLanguage,state,street,tenantType
+  e65b162c-6f87-4eb1-a24e-1b37d3504663,,,,IE,2023-02-21T19:56:38Z,,Contoso,,,,,,en,,,AAD
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra organization list --debug "false" --verbose "false"
+
+  Date: 4/18/2025
+
+  ## Contoso (e65b162c-6f87-4eb1-a24e-1b37d3504663)
+
+  Property | Value
+  ---------|-------
+  id | e65b162c-6f87-4eb1-a24e-1b37d3504663
+  countryLetterCode | IE
+  createdDateTime | 2023-02-21T19:56:38Z
+  displayName | Contoso
+  preferredLanguage | en
+  tenantType | AAD
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Organization: https://learn.microsoft.com/graph/api/organization-list

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/graph/openextension/openextension-set.mdx

@@ -0,0 +1,97 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph openextension set
+
+Updates an open extension for a resource
+
+## Usage
+
+```sh
+m365 graph openextension set [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the open extension.
+
+`-i, --resourceId <resourceId>`
+: The Id of the resource for which to update the open extension.
+
+`-t, --resourceType <resourceType>`
+: The type of resource. Allowed values are `user`, `group`, `device`, `organization`.
+
+`-k, --keepUnchangedProperties`
+: Keeps unspecified properties. Without this flag, any property that is not updated will be removed from the extension.
+```
+
+<Global />
+
+## Remarks
+
+This command allows using unknown options to update custom data of the open extension.
+
+When updating an open extension to a user, it's possible to use the UPN as the resourceId.
+
+:::warning[Escaping JSON in PowerShell]
+
+When updating open extensions it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
+:::info
+
+If a property of the open extension is not specified, the property is removed from the open extension.
+
+If a property of the open extension is not specified and `keepUnchangedProperties` is specified, the property will be kept in the open extension.
+
+:::
+
+## Examples
+
+Updates an open extension for a user specified by id
+
+```sh
+m365 graph openextension set --userId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user --theme dark --color red --language English
+```
+
+Updates an open extension for a user specified by UPN
+
+```sh
+m365 graph openextension set --userName john.doe@contoso.com --name 'com.contoso.roamingSettings' --resourceType user --theme dark --color red --language English
+```
+
+Updates an open extension for a group specified by id, one of the property represents a JSON object
+
+```sh
+m365 graph openextension set --resourceId c956e711-f074-40c3-8431-fbd69bb67d9c --name 'com.contoso.roamingSettings' --resourceType group --settings '{"theme": "dark", "color": "red" }'
+```
+
+Updates an open extension, but keeps the properties that are not specified
+
+```sh
+m365 graph openextension set --userId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user --color red --keepUnchangedProperties
+```
+
+Updates an open extension, but removes the properties that are not specified
+
+```sh
+m365 graph openextension set --userId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user --color red
+```
+
+Clears the value of the property
+
+```sh
+m365 graph openextension set --userId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user --theme ""
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- Open extensions: https://learn.microsoft.com/graph/extensibility-overview?tabs=http#open-extensions

package/docs/docs/cmd/spe/container/container-activate.mdx

@@ -1,6 +1,4 @@
 import Global from '/docs/cmd/_global.mdx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
 
 # spe container activate