@pnp/cli-microsoft365 7.2.0-beta.2970c86 → 7.2.0-beta.a021bb1

package/dist/m365/tenant/commands/people/people-profilecardproperty-add.js

@@ -18,7 +18,6 @@ class TenantPeopleProfileCardPropertyAddCommand extends GraphCommand {
     constructor() {
         super();
         _TenantPeopleProfileCardPropertyAddCommand_instances.add(this);
-        this.excludeOptions = ['name', 'displayName', 'debug', 'verbose', 'output'];
         __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyAddCommand_instances, "m", _TenantPeopleProfileCardPropertyAddCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyAddCommand_instances, "m", _TenantPeopleProfileCardPropertyAddCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertyAddCommand_instances, "m", _TenantPeopleProfileCardPropertyAddCommand_initValidators).call(this);
@@ -72,7 +71,7 @@ class TenantPeopleProfileCardPropertyAddCommand extends GraphCommand {
         ];
     }
     getLocalizations(options) {
-        const unknownOptions = Object.keys(options).filter(key => !this.excludeOptions.includes(key));
+        const unknownOptions = Object.keys(this.getUnknownOptions(options));
         if (unknownOptions.length === 0) {
             return [];
         }
@@ -88,8 +87,12 @@ class TenantPeopleProfileCardPropertyAddCommand extends GraphCommand {
 }
 _TenantPeopleProfileCardPropertyAddCommand_instances = new WeakSet(), _TenantPeopleProfileCardPropertyAddCommand_initTelemetry = function _TenantPeopleProfileCardPropertyAddCommand_initTelemetry() {
     this.telemetry.push((args) => {
+        // Add unknown options to telemetry
+        const unknownOptions = Object.keys(this.getUnknownOptions(args.options));
+        const unknownOptionsObj = unknownOptions.reduce((obj, key) => ({ ...obj, [key]: true }), {});
         Object.assign(this.telemetryProperties, {
-            displayName: typeof args.options.displayName !== 'undefined'
+            displayName: typeof args.options.displayName !== 'undefined',
+            ...unknownOptionsObj
         });
     });
 }, _TenantPeopleProfileCardPropertyAddCommand_initOptions = function _TenantPeopleProfileCardPropertyAddCommand_initOptions() {
@@ -105,13 +108,13 @@ _TenantPeopleProfileCardPropertyAddCommand_instances = new WeakSet(), _TenantPeo
         if (profileCardPropertyNames.every(n => n.toLowerCase() !== propertyName)) {
             return `${args.options.name} is not a valid value for name. Allowed values are ${profileCardPropertyNames.join(', ')}`;
         }
-        if (propertyName.startsWith("customattribute") && args.options.displayName === undefined) {
+        if (propertyName.startsWith('customattribute') && args.options.displayName === undefined) {
             return `The option 'displayName' is required when adding customAttributes as profile card properties`;
         }
-        if (!propertyName.startsWith("customattribute") && args.options.displayName !== undefined) {
+        if (!propertyName.startsWith('customattribute') && args.options.displayName !== undefined) {
             return `The option 'displayName' can only be used when adding customAttributes as profile card properties`;
         }
-        const unknownOptions = Object.keys(args.options).filter(key => !this.excludeOptions.includes(key));
+        const unknownOptions = Object.keys(this.getUnknownOptions(args.options));
         if (!propertyName.startsWith('customattribute') && unknownOptions.length > 0) {
             return `Unknown options like ${unknownOptions.join(', ')} are only supported with customAttributes`;
         }

package/dist/m365/tenant/commands/people/people-profilecardproperty-get.js

@@ -26,8 +26,10 @@ class TenantPeopleProfileCardPropertyGetCommand extends GraphCommand {
             if (this.verbose) {
                 await logger.logToStderr(`Retrieving information about profile card property '${args.options.name}'...`);
             }
+            // Get the right casing for the profile card property name
+            const profileCardProperty = profileCardPropertyNames.find(p => p.toLowerCase() === args.options.name.toLowerCase());
             const requestOptions = {
-                url: `${this.resource}/v1.0/admin/people/profileCardProperties/${args.options.name}`,
+                url: `${this.resource}/v1.0/admin/people/profileCardProperties/${profileCardProperty}`,
                 headers: {
                     accept: 'application/json;odata.metadata=none'
                 },

package/dist/m365/tenant/commands/people/people-profilecardproperty-list.js

@@ -1,6 +1,6 @@
 import GraphCommand from '../../../base/GraphCommand.js';
-import request from '../../../../request.js';
 import commands from '../../commands.js';
+import { odata } from '../../../../utils/odata.js';
 class TenantPeopleProfileCardPropertyListCommand extends GraphCommand {
     get name() {
         return commands.PEOPLE_PROFILECARDPROPERTY_LIST;
@@ -8,25 +8,15 @@ class TenantPeopleProfileCardPropertyListCommand extends GraphCommand {
     get description() {
         return 'Lists all profile card properties';
     }
-    constructor() {
-        super();
-    }
     async commandAction(logger, args) {
         try {
             if (this.verbose) {
-                await logger.logToStderr(`Lists all profile card properties...`);
+                await logger.logToStderr(`Listing all profile card properties...`);
             }
-            const requestOptions = {
-                url: `${this.resource}/v1.0/admin/people/profileCardProperties`,
-                headers: {
-                    accept: 'application/json;odata.metadata=none'
-                },
-                responseType: 'json'
-            };
-            const result = await request.get(requestOptions);
+            const result = await odata.getAllItems(`${this.resource}/v1.0/admin/people/profileCardProperties`);
             let output = result;
             if (args.options.output && args.options.output !== 'json') {
-                output = output.value.sort((n1, n2) => {
+                output = output.sort((n1, n2) => {
                     const localizations1 = n1.annotations[0]?.localizations?.length ?? 0;
                     const localizations2 = n2.annotations[0]?.localizations?.length ?? 0;
                     if (localizations1 > localizations2) {

package/dist/m365/tenant/commands/people/people-profilecardproperty-set.js

@@ -0,0 +1,118 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TenantPeopleProfileCardPropertySetCommand_instances, _TenantPeopleProfileCardPropertySetCommand_initTelemetry, _TenantPeopleProfileCardPropertySetCommand_initOptions, _TenantPeopleProfileCardPropertySetCommand_initValidators, _TenantPeopleProfileCardPropertySetCommand_initTypes;
+import GraphCommand from '../../../base/GraphCommand.js';
+import request from '../../../../request.js';
+import { profileCardPropertyNames as allProfileCardPropertyNames } from './profileCardProperties.js';
+import commands from '../../commands.js';
+class TenantPeopleProfileCardPropertySetCommand extends GraphCommand {
+    get name() {
+        return commands.PEOPLE_PROFILECARDPROPERTY_SET;
+    }
+    get description() {
+        return 'Updates a custom attribute to the profile card property';
+    }
+    constructor() {
+        super();
+        _TenantPeopleProfileCardPropertySetCommand_instances.add(this);
+        this.profileCardPropertyNames = allProfileCardPropertyNames.filter(p => p.toLowerCase().startsWith('customattribute'));
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertySetCommand_instances, "m", _TenantPeopleProfileCardPropertySetCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertySetCommand_instances, "m", _TenantPeopleProfileCardPropertySetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertySetCommand_instances, "m", _TenantPeopleProfileCardPropertySetCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _TenantPeopleProfileCardPropertySetCommand_instances, "m", _TenantPeopleProfileCardPropertySetCommand_initTypes).call(this);
+    }
+    allowUnknownOptions() {
+        return true;
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Updating profile card property '${args.options.name}'...`);
+            }
+            // Get the right casing for the profile card property name
+            const profileCardProperty = this.profileCardPropertyNames.find(p => p.toLowerCase() === args.options.name.toLowerCase());
+            const requestOptions = {
+                url: `${this.resource}/v1.0/admin/people/profileCardProperties/${profileCardProperty}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json',
+                data: {
+                    annotations: [
+                        {
+                            displayName: args.options.displayName,
+                            localizations: this.getLocalizations(args.options)
+                        }
+                    ]
+                }
+            };
+            const result = await request.patch(requestOptions);
+            let output = result;
+            // Transform the output to make it more readable
+            if (args.options.output && args.options.output !== 'json' && result.annotations.length > 0) {
+                output = result.annotations[0].localizations.reduce((acc, curr) => ({
+                    ...acc,
+                    ['displayName ' + curr.languageTag]: curr.displayName
+                }), {
+                    ...result,
+                    displayName: result.annotations[0].displayName
+                });
+                delete output.annotations;
+            }
+            await logger.log(output);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    /**
+     * Transform option to localization object.
+     * @example Transform "--displayName-en-US 'Cost center'" to { languageTag: 'en-US', displayName: 'Cost center' }
+     */
+    getLocalizations(options) {
+        const unknownOptions = this.getUnknownOptions(options);
+        const result = Object.keys(unknownOptions).map(o => ({
+            languageTag: o.substring(o.indexOf('-') + 1),
+            displayName: unknownOptions[o]
+        }));
+        return result;
+    }
+}
+_TenantPeopleProfileCardPropertySetCommand_instances = new WeakSet(), _TenantPeopleProfileCardPropertySetCommand_initTelemetry = function _TenantPeopleProfileCardPropertySetCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        // Add unknown options to telemetry
+        const unknownOptions = Object.keys(this.getUnknownOptions(args.options));
+        const unknownOptionsObj = unknownOptions.reduce((obj, key) => ({ ...obj, [key]: true }), {});
+        Object.assign(this.telemetryProperties, {
+            displayName: typeof args.options.displayName !== 'undefined',
+            ...unknownOptionsObj
+        });
+    });
+}, _TenantPeopleProfileCardPropertySetCommand_initOptions = function _TenantPeopleProfileCardPropertySetCommand_initOptions() {
+    this.options.unshift({
+        option: '-n, --name <name>',
+        autocomplete: this.profileCardPropertyNames
+    }, {
+        option: '-d, --displayName <displayName>'
+    });
+}, _TenantPeopleProfileCardPropertySetCommand_initValidators = function _TenantPeopleProfileCardPropertySetCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (!this.profileCardPropertyNames.some(p => p.toLowerCase() === args.options.name.toLowerCase())) {
+            return `'${args.options.name}' is not a valid value for option name. Allowed values are: ${this.profileCardPropertyNames.join(', ')}.`;
+        }
+        // Unknown options are allowed only if they start with 'displayName-'
+        const unknownOptionKeys = Object.keys(this.getUnknownOptions(args.options));
+        const invalidOptionKey = unknownOptionKeys.find(o => !o.startsWith('displayName-'));
+        if (invalidOptionKey) {
+            return `Invalid option: '${invalidOptionKey}'`;
+        }
+        return true;
+    });
+}, _TenantPeopleProfileCardPropertySetCommand_initTypes = function _TenantPeopleProfileCardPropertySetCommand_initTypes() {
+    this.types.string.push('name', 'displayName');
+};
+export default new TenantPeopleProfileCardPropertySetCommand();
+//# sourceMappingURL=people-profilecardproperty-set.js.map

package/dist/m365/tenant/commands.js

@@ -6,6 +6,7 @@ export default {
     PEOPLE_PROFILECARDPROPERTY_GET: `${prefix} people profilecardproperty get`,
     PEOPLE_PROFILECARDPROPERTY_LIST: `${prefix} people profilecardproperty list`,
     PEOPLE_PROFILECARDPROPERTY_REMOVE: `${prefix} people profilecardproperty remove`,
+    PEOPLE_PROFILECARDPROPERTY_SET: `${prefix} people profilecardproperty set`,
     REPORT_ACTIVEUSERCOUNTS: `${prefix} report activeusercounts`,
     REPORT_ACTIVEUSERDETAIL: `${prefix} report activeuserdetail`,
     REPORT_OFFICE365ACTIVATIONCOUNTS: `${prefix} report office365activationcounts`,

package/docs/docs/cmd/tenant/people/people-profilecardproperty-add.mdx

@@ -66,54 +66,6 @@ m365 tenant people profilecardproperty add --name customAttribute1 --displayName
 
 ## Response
 
-### Standard response
-
-<Tabs>
-  <TabItem value="JSON">
-
-  ```json
-  {
-    "directoryPropertyName": "UserPrincipalName",
-    "annotations": []
-  }
-  ```
-
-  </TabItem>
-  <TabItem value="Text">
-
-  ```text
-  annotations          : []
-  directoryPropertyName: UserPrincipalName
-  ```
-
-  </TabItem>
-  <TabItem value="CSV">
-
-  ```csv
-  directoryPropertyName
-  UserPrincipalName
-  ```
-
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  # tenant people profilecardproperty add --name 'UserPrincipalName'
-
-  Date: 11/2/2023
-
-  Property | Value
-  ---------|-------
-  directoryPropertyName | UserPrincipalName
-  ```
-
-  </TabItem>
-</Tabs>
-
-### Response with a customAttribute
-
-When we make use of one of the customAttributes, the response will differ. 
-
 <Tabs>
   <TabItem value="JSON">
 

package/docs/docs/cmd/tenant/people/people-profilecardproperty-get.mdx

@@ -95,3 +95,7 @@ m365 tenant people profilecardproperty get --name customAttribute1
 
   </TabItem>
 </Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/add-properties-profilecard

package/docs/docs/cmd/tenant/people/people-profilecardproperty-list.mdx

@@ -38,8 +38,7 @@ m365 tenant people profilecardproperty list
   <TabItem value="JSON">
 
   ```json
-  {
-  "value": [
+  [
     {
       "directoryPropertyName": "customAttribute1",
       "annotations": [
@@ -53,13 +52,8 @@ m365 tenant people profilecardproperty list
           ]
         }
       ]
-    },
-    {
-      "directoryPropertyName": "Alias",
-      "annotations": []
     }
   ]
-}
   ```
 
   </TabItem>
@@ -69,7 +63,6 @@ m365 tenant people profilecardproperty list
   directoryPropertyName  displayName     displayName de
   ---------------------  --------------  --------------
   customAttribute1       Cost center     Kostenstelle
-  Alias
   ```
 
   </TabItem>
@@ -78,7 +71,6 @@ m365 tenant people profilecardproperty list
   ```csv
   directoryPropertyName,displayName,displayName de
   customAttribute1,Cost center,Kostenstelle
-  Alias,,
   ```
 
   </TabItem>
@@ -96,11 +88,11 @@ m365 tenant people profilecardproperty list
   directoryPropertyName | customAttribute1
   displayName | Cost center
   displayName de | Kostenstelle
-
-  Property | Value
-  ---------|-------
-  directoryPropertyName | Alias
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/add-properties-profilecard

package/docs/docs/cmd/tenant/people/people-profilecardproperty-set.mdx

@@ -0,0 +1,120 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty set
+
+Updates a custom attribute to the profile card property
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty set [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the property to update. Allowed values: `customAttribute1`, `customAttribute2`, `customAttribute3`, `customAttribute4`, `customAttribute5`, `customAttribute6`, `customAttribute7`, `customAttribute8`, `customAttribute9`, `customAttribute10`, `customAttribute11`, `customAttribute12`, `customAttribute13`, `customAttribute14`, `customAttribute15`.
+
+`-d, --displayName <displayName>`
+: The display name of the property.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Tenant Administrator** or **Global Administrator**.
+
+:::
+
+:::info
+
+You can specify localized values for the `displayName` as well. These can be entered by suffixing the displayName option with a language code: `--displayName-nl-NL "Kostencentrum"`, `--displayName-de "Kostenstelle"`.
+
+:::
+
+:::caution
+
+When updating an attribute to a profile card, it takes up to 24 hours for the addition to be displayed.
+
+:::
+
+## Examples
+
+Updates a custom extension attribute to Cost Center
+
+```sh
+m365 tenant people profilecardproperty set --name customAttribute1 --displayName "Cost Center"
+```
+
+Updates a custom extension attribute with translations
+
+```sh
+m365 tenant people profilecardproperty set --name customAttribute1 --displayName "Cost Center" --displayName-nl-NL "Kostencentrum" --displayName-de "Kostenstelle"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "directoryPropertyName": "customAttribute1",
+    "annotations": [
+      {
+        "displayName": "Cost center",
+        "localizations": [
+          {
+            "languageTag": "nl-NL",
+            "displayName": "Kostenplaats"
+          }
+        ]
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryPropertyName: customAttribute1
+  displayName          : Cost center
+  displayName nl-NL    : Kostenplaats
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  directoryPropertyName,displayName,displayName nl-NL
+  customAttribute1,Cost center,Kostenplaats
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # tenant people profilecardproperty set --name 'customAttribute1' --displayName 'Cost center' --displayName-nl-NL 'Kostenplaats'
+
+  Date: 11/2/2023
+
+  Property | Value
+  ---------|-------
+  directoryPropertyName | customAttribute1
+  displayName           | Cost center
+  displayName nl-NL     | Kostenplaats
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/add-properties-profilecard

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "7.2.0-beta.2970c86",
+  "version": "7.2.0-beta.a021bb1",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -156,6 +156,7 @@
     "Hunt, Geoffrey <info@runningdeveloper.com>",
     "Hvam, Allan <ahp@delegate.dk>",
     "Jaakke, Robert <robert.jaakke@mavention.nl>",
+    "Junker Aaron <aaron.junker@outlook.com>",
     "Kailasam, Balamurugan <kshsbala@engineer.com>",
     "Karda, Akash <akashkarda@gmail.com>",
     "Kasireddy, Prasad <prasad.gietcse@gmail.com>",
@@ -174,6 +175,7 @@
     "Levert, Sebastien <slevert@outlook.com>",
     "Lingstuyl, Martin <mlingstuyl@live.com>",
     "Macháček, Martin <machacek@edhouse.cz>",
+    "Maestrini Tobias <tobias@bee365.ch>",
     "Maillot, Michaël <battosaimykle@gmail.com>",
     "Mastykarz, Waldek <waldek@mastykarz.nl>",
     "McDonnell, Kevin <kevin@mcd79.com>",