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

package/docs/docs/cmd/aad/administrativeunit/administrativeunit-list.mdx

@@ -0,0 +1,87 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# aad administrativeunit list
+
+Retrieves a list of administrative units
+
+## Usage
+
+```sh
+m365 aad administrativeunit list [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+Retrieve a list of administrative units
+
+```sh
+m365 aad administrativeunit list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "0a22c83d-c4ac-43e2-bb5e-87af3015d49f",
+      "deletedDateTime": null,
+      "displayName": "Marketing Department",
+      "description": "Marketing Department Administration",
+      "membershipRule": null,
+      "membershipType": null,
+      "membershipRuleProcessingState": null,
+      "visibility": "HiddenMembership"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  displayName: 0a22c83d-c4ac-43e2-bb5e-87af3015d49f
+  id         : Marketing Department
+  visibility : HiddenMembership
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,description,visibility
+  0a22c83d-c4ac-43e2-bb5e-87af3015d49f,Marketing Department,Marketing Department Administration,HiddenMembership
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # aad administrativeunit list
+
+  Date: 2023-10-16
+
+  ## Marketing Department (0a22c83d-c4ac-43e2-bb5e-87af3015d49f)
+
+  Property | Value
+  ---------|-------
+  id | 0a22c83d-c4ac-43e2-bb5e-87af3015d49f
+  displayName | Marketing Department
+  description | Marketing Department Administration
+  visibility | HiddenMembership
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

package/docs/docs/cmd/aad/administrativeunit/administrativeunit-remove.mdx

@@ -0,0 +1,56 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# aad administrativeunit remove
+
+Removes an administrative unit
+
+## Usage
+
+```sh
+m365 aad administrativeunit remove [options]
+```
+
+## options
+
+```md definition-list
+`-i, --id [id]`
+: The id of the administrative unit. Specify either `id` or `displayName` but not both.
+
+`-n, --displayName [displayName]`
+: The display name of the administrative unit. Specify either `id` or `displayName` but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Global Administrator** or **Privileged Role Administrator**.
+
+:::
+
+## Examples
+
+Remove an administrative unit by its id
+
+```sh
+m365 aad administrativeunit remove --id 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+```
+
+Remove an administrative unit by it displayName
+
+```sh
+m365 aad administrativeunit remove --displayName 'Marketing Division'
+```
+
+## Response
+
+The command won't return a response on success
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

package/docs/docs/cmd/spfx/project/project-upgrade.mdx

@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.18.0).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.18.1-rc.0).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

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

@@ -0,0 +1,174 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty add
+
+Adds an additional attribute to the profile card properties
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the property to add. Allowed values: `UserPrincipalName`, `Fax`, `StreetAddress`, `PostalCode`, `StateOrProvince`, `Alias`, `customAttribute1`, `customAttribute2`, `customAttribute3`, `customAttribute4`, `customAttribute5`, `customAttribute6`, `customAttribute7`, `customAttribute8`, `customAttribute9`, `customAttribute10`, `customAttribute11`, `customAttribute12`, `customAttribute13`, `customAttribute14`, `customAttribute15`.
+
+`-d, --displayName [displayName]`
+: The display name of a property, only use this together with a custom extension attribute.
+```
+
+<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 adding an attribute to a profile card, it takes up to 24 hours for the addition to be displayed.
+
+:::
+
+## Examples
+
+Add the UPN as a profile property to the profile cards properties
+
+```sh
+m365 tenant people profilecardproperty add --name UserPrincipalName
+```
+
+Add a custom extension attribute _Cost Center_ as a profile property to the profile cards properties
+
+```sh
+m365 tenant people profilecardproperty add --name customAttribute1 --displayName 'Cost Center'
+```
+
+Add a custom extension attribute _Cost Center_ as a profile property to the profile cards properties with a Dutch localization
+
+```sh
+m365 tenant people profilecardproperty add --name customAttribute1 --displayName 'Cost Center' --displayName-nl-NL 'Kostencentrum'
+```
+
+## 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">
+
+  ```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 add --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/docs/docs/cmd/tenant/people/people-profilecardproperty-get.mdx

@@ -0,0 +1,97 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty get
+
+Retrieves information about a specific profile card property
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty get [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the property to retrieve. Allowed values: `UserPrincipalName`, `Fax`, `StreetAddress`, `PostalCode`, `StateOrProvince`, `Alias`, `customAttribute1`, `customAttribute2`, `customAttribute3`, `customAttribute4`, `customAttribute5`, `customAttribute6`, `customAttribute7`, `customAttribute8`, `customAttribute9`, `customAttribute10`, `customAttribute11`, `customAttribute12`, `customAttribute13`, `customAttribute14`, `customAttribute15`.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Tenant Administrator** or **Global Administrator**.
+
+:::
+
+## Examples
+
+Retrieve information about a specific profile card property
+
+```sh
+m365 tenant people profilecardproperty get --name customAttribute1
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "directoryPropertyName": "customAttribute1",
+    "annotations": [
+      {
+        "displayName": "Cost center",
+        "localizations": [
+          {
+            "languageTag": "nl-NL",
+            "displayName": "Kostencentrum"
+          }
+        ]
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryPropertyName: customAttribute1
+  displayName          : Cost center
+  displayName nl-NL    : Kostencentrum
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  directoryPropertyName,displayName,displayName nl-NL
+  customAttribute1,Cost center,Kostencentrum
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # tenant people profilecardproperty get --name "customAttribute1"
+
+  Date: 3/11/2023
+
+  ## Cost center
+
+  Property | Value
+  ---------|-------
+  directoryPropertyName | customAttribute1
+  displayName | Cost center
+  displayName nl-NL | Kostencentrum
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -0,0 +1,106 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty list
+
+Lists all profile card properties
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty list [options]
+```
+
+## Options
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Tenant Administrator** or **Global Administrator**.
+
+:::
+
+## Examples
+
+Lists all profile card properties
+
+```sh
+m365 tenant people profilecardproperty list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+  "value": [
+    {
+      "directoryPropertyName": "customAttribute1",
+      "annotations": [
+        {
+          "displayName": "Cost center",
+          "localizations": [
+            {
+              "languageTag": "de",
+              "displayName": "Kostenstelle"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "directoryPropertyName": "Alias",
+      "annotations": []
+    }
+  ]
+}
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryPropertyName  displayName     displayName de
+  ---------------------  --------------  --------------
+  customAttribute1       Cost center     Kostenstelle
+  Alias
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  directoryPropertyName,displayName,displayName de
+  customAttribute1,Cost center,Kostenstelle
+  Alias,,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # tenant people profilecardproperty list
+
+  Date: 11/4/2023
+
+  ## Cost center
+
+  Property | Value
+  ---------|-------
+  directoryPropertyName | customAttribute1
+  displayName | Cost center
+  displayName de | Kostenstelle
+
+  Property | Value
+  ---------|-------
+  directoryPropertyName | Alias
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -0,0 +1,61 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty remove
+
+Removes an additional attribute from the profile card properties
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty remove [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the property to remove. Allowed values: `UserPrincipalName`, `Fax`, `StreetAddress`, `PostalCode`, `StateOrProvince`, `Alias`, `customAttribute1`, `customAttribute2`, `customAttribute3`, `customAttribute4`, `customAttribute5`, `customAttribute6`, `customAttribute7`, `customAttribute8`, `customAttribute9`, `customAttribute10`, `customAttribute11`, `customAttribute12`, `customAttribute13`, `customAttribute14`, `customAttribute15`.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Tenant Administrator** or **Global Administrator**.
+
+:::
+
+:::caution
+
+When removing an attribute from a profile card, it takes up to 24 hours for the change to be displayed.
+
+:::
+
+## Examples
+
+Removes the UPN as a profile property from the profile cards
+
+```sh
+m365 tenant people profilecardproperty remove --name UserPrincipalName
+```
+
+Removes the UPN as a profile property from the profile cards, without showing a confirmation prompt
+
+```sh
+m365 tenant people profilecardproperty remove --name UserPrincipalName --force
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- https://learn.microsoft.com/graph/add-properties-profilecard

package/npm-shrinkwrap.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "7.1.0",
+  "version": "7.2.0-beta.2970c86",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -173,6 +173,7 @@
     "Lengelle, Veronique <25181757+veronicageek@users.noreply.github.com>",
     "Levert, Sebastien <slevert@outlook.com>",
     "Lingstuyl, Martin <mlingstuyl@live.com>",
+    "Macháček, Martin <machacek@edhouse.cz>",
     "Maillot, Michaël <battosaimykle@gmail.com>",
     "Mastykarz, Waldek <waldek@mastykarz.nl>",
     "McDonnell, Kevin <kevin@mcd79.com>",
@@ -300,4 +301,4 @@
     "sinon": "^15.2.0",
     "source-map-support": "^0.5.21"
   }
-}
+}